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1 ABOUT THIS GUIDE 





1.1 Objectives and target audience 


This guide provides details on how to connect your website to the Skrill Wallet Checkout using the 
Skrill Wallet service. It is intended for users who have a working knowledge of HTML. The guide 
covers the steps in the payment process and the information that needs to be passed from your web 
servers to Skrill, to enable Skrill to process payments. 


This guide is only relevant to Skrill Wallet merchants. 


1.2 PCI disclaimer 


In accordance with the Payment Card Industry Data Security Standard in force as updated from time 
to time (“PCI-DSS”), If a Skrill Account holder uses their credit or debit card to upload funds to their 
Skrill Account, Skrill will be responsible for the security of all cardholder data processed, stored or 
transmitted by Skrill when providing the Skrill Services. 


1.3 Related documentation 


You should use this guide together with the additional Skrill Wallet Checkout documents described 








below. 

Guide Description 

Automated Payments Interface Describes how to connect to Skrill using the Automated Payments 

Guide Interface (API). This supports functionality such as merchant queries 
against the system, sending money and processing refunds (where 
available). 

Skrill Customer Verification Describes how to use the Skrill Customer Verification service to check if a 

Service Guide customer, identified by an email address or customer ID, is registered with 


Skrill. The service also lets you verify information that you hold about the 
customer against Skrill’s registration records, such as email address, first 
name, last name, date of birth and address. 





1.4 Conventions used in this guide 


The table below lists some of the conventions used in this guide. 


Table 1: List of conventions 





Convention Description 


Reference Indicates a reference to another section in this guide. For example, 
refer to the /ntroduction on page 5. 





File path Used to indicate a file path or folder structure. 





Glossary Glossary term 
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2 INTRODUCTION 





The Skrill Wallet Checkout is a secure Skrill site, where you redirect customers from your website to 
make a Wallet payment through Skrill. The payment gateway collects customer payment details 
using standard HTML forms. 


After the payment is complete, the customer is returned to your website and you receive a real-time 
notification of the payment, which includes details of the transaction. 


Requesting a test account 


You may need a test account to test your integration to the Skrill Wallet Checkout. Test accounts 
work in a live environment; however, funds cannot be sent from a test account to a live account. 


To set up a test account: 


1. Open an additional Skrill Digital Wallet account online via the Skrill website. 
2. Inform Skrill of the email address of the new account and request that this be enabled as a 


test account. 


Who to contact for queries 


For all support queries, contact the Merchant Services department. 


Email: merchantservices@skrill.com 


Language Telephone Number | Operating Times (weekdays) 
English +44 (0) 2083387760 | 8am - 5pm GMT 


English US +1 855 6225 167 8am - 6pm EST 


2.1 Connecting to the Wallet Checkout 


Connecting to the Skrill Wallet Checkout requires adding Skrill as a payment method on your 
websites checkout or payment page. When your customer selects Skrill, you should ensure that 
they are redirected to the Skrill Wallet Checkout. At the same time, you will need to submit 
information about the payment, such as your merchant account email, amount to be paid, and 
several other hidden text fields. 


You can use a standard HTML form to collect and pass payment and customer details to Skrill. An 
example of an HTML form is shown in section 6.6.Example HTML form on page 83. 


A simplified illustration of the transaction flow is shown in Figure 1 below. 
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5.000 ¿10% 0| 10 ¡0 





Card Issuer 


Figure 1 Skrill transaction flow 


1. When the customer is ready to pay for goods or services on your website, they select the 
Skrill payment option on your website. 

2. Yourequest a session identifier (SID) by passing customer and transaction details (e.g., 
amount, currency and language) to the Skrill Wallet Checkout. 

3. Skrill returns the generated SID. 

4. Using a light box or iframe you redirect the customer to the Skrill Wallet Checkout and 
include the session identifier in the redirect URL. Skrill displays the relevant payment page. 

5. The customer enters their payment information, plus any other details requested, and 
confirm the transaction. 

6. Skrill requests authorisation for the payment from the customer’s bank, third party provider 
or card issuer. 

7. The bank/provider approves or rejects the transaction. 

8. We display the confirmation page, containing the transaction result, on the Skrill Wallet 
Checkout. 

9. Skrill provides you with an asynchronous notification to your status URL or IPN (instant 
Payment Notification), confirming the transaction details and status. 
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2.1.1 The payment process 


Figure 2 below provides a more detailed view of the interaction between customer, merchant and Skrill 
in a typical transaction. Note that some details have been left out to simplify the diagram. 





Em Skrill 


Customer Merchant 













Selects Skrill payment 
option Browser POSTs payment parameters e.g. 
payment amount using SSL 








Login/Register 





== == = == 


j 
I 
| 
l 


E N 
| Enters additional | Executes payment 


Selects payment 








T > , Merchant receives 
method Customer may be directed to externall \ payment details P, funds | 
providers to execute payment. | * 
(e.g. online banking) EXTERNAL PROVIDERS E.G. SOFORT, PAYSAFECARD, Etc. | 


Customer may need to enter additional details before clicking Pay Now Executes payment. 
Merchant receives 
funds 


Clicks PAY NOW 


button 





Cancel url 





Clicks Cancel Failed Payment 
Button to cancel 


payment 













Sends confirmation 
to status url 


Deliver Services 








Return url 


Figure 2: Payment flow between customer, merchant and Skrill 
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2.2 Steps in the payment process 


Payment details are collected from the customer, and you are notified of the result. The customer is 
then automatically returned to the relevant page on your website: 


Redirect Customer login / Choose Payment Skrill Return to 
customer to registration Method and Pay Transaction Merchant 
Skrill Payment status page website 


Page / iframe 


2.2.1 Redirecting customers to the Skrill Gateway (Step 1) 


When a customer is on the online checkout or payment page on your website, they should be 
presented with a Pay by Skrill logo or button (see examples below). 


Skrill (Skill, 


You can download a copy of these logos from the Skrill website at: 
https://www.skrill.com/en/merchants/brand-centre 


When they select the Skrill button, your website should post the HTML form containing their 


transaction details to https://pay.skrill.com. 
The HTML form should contain the hidden input fields listed in Table 2 below. 


Note: To maximise conversion, Skrill recommends that you redirect customers to the Skrill Wallet 


on page 38). When using the standard Skrill page, the minimum width of the window or frame 
should be at least 600 pixels. 





Skrill Wallet checkout demonstration 


If you want a demonstration of the Skrill Wallet Checkout you can access a test form at: 
https://www.skrill.com/app/test payment.pl. 





Note: transactions are processed as real payments unless you use a demo account and demo cards. 
Contact the Merchant Services department merchantservices@skrill.com for a demo account. 





Download payment method logos 


Skrill logos and payment method icons that can be displayed on your website are available at: 
https://www.skrill.com/en/merchants/brand-centre 





Note: You will need your Skrill Account customer ID to use this section of Skrill.com, see 


https://help.skrill.com/en/Article/my-money/deposits/how-do-i-locate-my-customer-id- 





number for details. 
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Note: All URL parameters must include the scheme at the front of the URL e.g. https://. For example, 
instead of www.google.co.uk you would need to use https://www.google.co.uk 





Table 2: Skrill Wallet checkout parameters 





Field name 


Description 


Required 


Max 


length 


Example value 





Merchant Details 





pay_to_email 


Email address of your Skrill merchant 
account. 


Yes 


50 


info@example.com 





recipient_description 


A description to be shown on the Skrill 
payment page in the logo area if there 
is no logo_url parameter. If no value is 
submitted and there is no logo, the 
pay_to_email value is shown as the 
recipient of the payment. 


No 


30 


Your Company Name 





transaction_id 


Your unique reference or identification 
number for the transaction. (Must be 
unique for each payment) 


No 


100 


A205220 





return_url 


URL to which the customer is returned 
once the payment is made. If this field is 
not filled, the Skrill payment page closes 
automatically at the end of the 
transaction and the customer is 
returned to the page on your website 
from where they were redirected to 
Skrill. A secure return_url option is 
available. (See section 3.4 on page 36.) 


No 


240 


https: //www.example. 


com/payment.htm 





return_url_text 


The text on the button when the 
customer finishes their payment. 


No 


35 


Return to main 
website 





return_url_target 


Specifies a target in which the 
return_url value is displayed upon 
successful payment from the customer. 
Default value is 1. 


1=' top' 

2 ='_parent' 
3=' self 
4='_blank' 


No 





cancel_url 





URL to which the customer is returned if 
the payment is cancelled or fails. If no 
cancel URL is provided, then the Cancel 
button is not displayed. 








No 


240 





https://www.example.c 
om/payment cancelled 
htm 
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Field name 


Description 


Required 


Example value 





cancel_url_target 


Specifies a target in which the 
cancel_url value is displayed upon 
cancellation of payment by the 
customer. Default value is 1. 


1=' top' 

2 ='_parent' 
3=' self 
4='_blank' 


No 








status_url 


URL to which the transaction details are 
posted after the payment process is 
complete. Alternatively, you may 
specify an email address where the 
results are sent. 


If the status_url is omitted, no 
transaction details are sent. 


Only the following ports are supported: 


80, 81, 82, 83, 88, 90, 178, 419, 433, 
443, 444, 448, 451, 666, 800, 888, 


1025, 1430, 1680, 1888, 1916, 1985, 
2006, 2221, 3000, 4111, 4121, 4423, 


4440, 4441, 4442, 4443, 4450, 4451, 
4455, 4567, 5443, 5507, 5653, 5654, 


5656, 5678, 6500, 7000, 7001, 7022, 
7102, 7777, 7878, 8000, 8001, 8002, 


8011, 8014, 8015, 8016, 8027, 8070, 
8080, 8081, 8082, 8085, 8086, 8088, 


8090, 8097, 8180, 8181, 8443, 8449, 
8680, 8843, 8888, 8989, 9006, 9088, 


9443, 9797, 10088, 10443, 12312, 
18049, 18079, 18080, 18090, 18443, 


20202, 20600, 20601, 20603, 20607, 
20611, 21301, 22240, 26004, 27040, 


28080, 30080, 37208, 37906, 40002, 
40005, 40080, 50001, 60080, 60443 


Note: These port restrictions apply to all 
Skrill status URLs 


No 


400 


www.example. 
rocess paymen 


https: 
com 


t.cqi 
OR 


mailto: 


info@example.com 





status_url2 





Second URL to which the transaction 
details are posted after the payment 
process is complete. Alternatively, you 
may specify an email address where the 
results are sent. 


The same port restrictions apply as for 
the status_url parameter above. 


No 








400 


www.example. 
rocess_paymen 


https: 
com 


t2.cqi 
OR 


mailto: 
info2@example.com 
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Max 
Field name Description Required Example value 
length 
language 2-letter code of the language used for No? 2 EN 
Skrill’s pages. Can be any of the codes in 
Not 
6.2 Languages supported by Skrill. see Note 
psp_id For Paysafecard transactions - offers the | No 16 A205220 
possibility to classify sub-merchants. 
Agreement with Paysafecard needed - 
not agreed values lead to a failed 
payment. 
submerchant_id Identification of the shop which is the No 120 Payment service 
originator of the request. This is most provider name 
likely used by the payment service 
providers who act as a proxy for other 
payment methods as well. 
submerchant_url URL of the website for which the Applicable | 240 http://www.example.c 
payment is made. for om 
resellers 
Submerchant name |The merchant’s name listed on the Applicable | 240 Example LTD 
website for which the payment is made | for 
resellers 
logo_url The URL of the logo which you would No 240 https://www.example. 
like to appear in the top right of the com/logo.jpeg 
Skrill page. The logo must be accessible 
via HTTPS, or it will not be shown. 
The logo will be resized to fit. To avoid 
scaling distortion, the minimum size 
should be as follows: 
e Ifthe logo width > height — at 
least 107px width. 
e Iflogo width > height — at least 
65px height 
Avoid large images (much greater than 
256 by 256px) to minimise the page 
loading time. 
prepare only Forces only the SID to be returned No 1 1 


without the actual page. Useful when 
using the secure method to redirect the 
customer to the payment page. For 
details, see section 2.2.2 on page 19. 
Accepted values are O (default) and 1 
(prepare only). 


Note: This parameter is required when 
enabling the Quick Checkout Secure 





Restriction by IP service. For details, see 
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Field name 


Description 


Required 


Max 


length 


Example value 





the Automated Payments Interface 
Guide. 





sid 


Session ID (SID). This is an optional 
parameter containing the Session ID 
returned by the prepare only call. If 
you use this parameter, then you 
should not supply any other 
parameters. For details, see section 
2.2.2 on page 19. 


No 


32 


OebSd0f6b94badfeae5 
b0364b26d0288 





rid 


You can pass a unique referral ID or 
email of an affiliate from which the 
customer is referred. The rid value must 
be included within the actual payment 
request. 


No 


100 


123456 





ext_ref_id 


You can pass additional identifier in this 
field to track your affiliates. You must 
inform your account manager about the 
exact value that will be submitted so 
that affiliates can be tracked. 


No 


100 


Affiliate Name 





merchant_fields 


Field1 


A comma-separated list of field names 
that are passed to the status URL when 
the payment is confirmed (maximum 5 
fields). 


An example merchant field 


No 


No 


240 


240 


Field1, Field2 


Value 1 





Field2 





An example merchant field 





No 





240 


Value 2 











Customer Details (used to speed up Registration / Login) 





pay_from_email 


Email address of the customer who is 
making the payment. If left empty, the 
customer must enter their email 
address. 


No 


100 


payer@skrill.com 





firstname 


Customer's first name 


No 


20 


John 





lastname 


Customer’s last name 


No 


50 


Payer 





date_of_birth 


Date of birth of the customer. The 
format is ddmmyyyy. Only numeric 
values are accepted. This saves time for 
Skrill Wallet sign-up which require the 
customer to enter a date of birth. 


No 


01121980 








address 





Customer's address (e.g. street) 





No 





100 





Payer street 





O Skrill 2021 


Page 16 





Skrill Wallet Guide 8.1 





















































Max 
Field name Description Required Example value 
length 
address2 Customer's address (e.g. town) No 100 Payer town 
phone_number Customer's phone number. Only No 20 0207123456 
numeric values are accepted 
postal_code Customer's postal code/ZIP Code. Only | No 9 EC45MQ 
alphanumeric values are accepted 
(e.g., no punctuation marks or dashes) 
city Customer’s city or postal area No 50 London 
state Customer’s state or region. No 50 Central London 
country Customer’s country in the 3-digit ISO No 3 GBR 
Code (see section 6.3 on page 79). 
Payment Details 
amount The total amount payable. Yes 19 39.68 
Note: Do not include the trailing zeroes SCH 
if the amount is a natural number. For OR 
example: “23” (not “23.00”). 39 
currency 3-letter code of the currency of the Yes 3 EUR 
amount according to ISO 4217 (see 
section 6.1 on page 77). 
amount2_description | You can include a calculation for the No 240 Product price: 
total amount payable, which is 
displayed in the "More information’ 
section in the header of the Skrill 
payment form. 
Note that Skrill does not check the 
validity of this data. 
amount2 This amount in the currency defined in | No 19 29.90 
the field 'currency' will be shown next 
to amount2_description. 
amount3_description |See above No 240 Handing fees € 
charges: 
amount3 See above No 19 3.10 
amount4_description |See above No 240 VAT (20%): 
amount4 See above No 19 6.60 
detail1_description You can show up to five additional No * 240 Product ID: 
details about the product in the "More 
See Note 
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Max 
Field name Description Required Example value 
length 





information' section in the header of 
the Skrill Gateway page. 





detaill text The detaill text is shown next to the No * 240 4509334 
detaill description in the More 
Information section in the header of the 
payment form with the other payment 
details. The detaill description 
combined with the detail1_text is shown 
in the more information field of the 
merchant account history CSV file. Using 
the example values, this would be 
Product ID: 4509334. This information is 
also shown to the customer in their Skrill 
Digital Wallet account history. 


See Note 





detail2_description See above. Note not shown in the No 240 Description: 
account history. 





detail2_text See above. Note not shown in the No 240 Romeo and Juliet 


account history. (W. Shakespeare) 





detail3_description See above. Note not shown in the No 240 Special Conditions: 
account history. 





detail3_text See above. Note not shown in the No 240 5-6 days for delivery 
account history. 





detail4_description See above. Note not shown in the No 240 
account history. 





detail4_text See above. Note not shown in the No 240 
account history. 





detail5_description See above. Note not shown in the No 240 
account history. 





detail5_text See above. Note not shown in the No 240 
account history. 























Note: The language, detail1_text, and detaill description parameters are not mandatory but are 
highly recommended for a good user experience. English is used as the default language if no 
language is provided. 





Language encoding for text parameters 


All text fields use UTF-8 encoding. Note however that the Wallet Checkout can only display Latin-1 
characters. 
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2.2.2 Recommended secure method of redirecting the customer 


This method can be used to ensure that details of the payment are communicated securely between 
your server and Skrill. 





Important! We strongly recommend that you use this method for redirecting your customers to 
Skrill, as it does not require sending any payment parameters to their browser. This prevents 
customers from being able to view or modify any hidden parameters in your source code. 





How to implement 


To ensure that details of the payment are communicated securely only between your server and 
Skrill: 


1. Your web server makes a standard POST request with the payment parameters, using the 
‘prepare_only’ parameter (see Table 2 above). 

2. The Skrill server prepares a session for the payment and returns a standard HTTP(S) 
response. 

3. Your web server takes the body of the response which contains a SESSION_ID value. 

4. Using this SESSION_ID value the customer can be redirected using a GET request to 
https://pay.skrill.com/?sid=<SESSION ID> 


The normal flow of events continues. This redirect must happen within 15 minutes of the original 
request, or the session will expire. 


For code examples of how to implement this, see section 3.9 on page 39. 





Note: The Skrill Payment Platform treats GET/POST requests to the payment URL identically. As a 
result, you can also use an HTTP GET operation in place of POST in step 1 above and pass the 
payment parameters as name / value pairs in the query string. Similarly, in Step 4 above you 
could use a HTTP POST operation and pass the SESSION ID value from Step 3 as the sid 
parameter in the message body. 
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2.2.3 Skrill customer login/registration (Step 2) 


When the customer submits the HTML form from their web browser, they are shown a Skrill page 
that displays the payment amount and payment details submitted to Skrill and presents two options: 
login or sign up. The two options are described in detail below. 


If the “pay from email” parameter is supplied then the email address field will be pre-filled; 
otherwise, this field will be empty. 


& English 


1.00ur La ACME 


Skrill account 
Email address 


payer@skrill.com 


Password Forgot? 


LOGIN 


Don't have an account? Sign up 


with just an email and password 


visa O ei =>" Ds 





Cancel 


Die Skrill 


Figure 3 Login page showing pre-filled email address 


The customer enters or changes their email (if required) followed by their password, selects the 
Login button, and is redirected to the next step, see Section 2.2.4 


If the customer does not have a Skrill account, they can sign-up by clicking the link SIGN UP link, see 
Section 2.2.3.1 below. 
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The customer can view the payment details by selecting the information icon, displayed to the right 
of the amount and currency. See the examples in Figure 4 and Figure 5. 


é English 
25.00EurR òs Aime E — Customer selects (i 
` - to view payment 


details 
Figure 4: Top of payment form shows total amount 





P ( x) 
Payment details | 


These labels are Mem code: XYZ1234 
configurable. You can Customer sees the 


have up to 8 Label/Value 0 order details you 
pairs. 13 description Total: 15.00 included in your 
fields containing text and payment request 


Item code: ABC1234 


3 amount fields contain su. 200 


numeric values. For Shipping: 5.00 
example, you could 





provide a product 


description + VAT and 
Shipping costs. Total 25.00 EUR 


CLOSE 


Figure 5: Payment details screen 











© Skrill 2021 Page 21 


Skrill Wallet Guide 8.1 
Payment details 


detail1_description: detail) 
detail2_description: detail2 
detail3_description: detail3 
detail4_description: detail4 
detail5_description: detail5 
amount2_description 1.00 

amount3 description 2.00 


amount4_description: 3.00 


Total 6.00 EUR 


CLOSE 


Figure 6 Detail and amount fields and associated description fields 


2.2.3.1 Customer is not registered with Skrill 


If the customer is not registered with Skrill, they can click SIGN UP. They are then presented with a 
registration form (see Figure 7 below). The form is used to register a customer for a Skrill Digital 
Wallet account. 


Fast registration 


To speed up the registration process, you can provide the following additional data to pre-fill the 
form: “address”, ‘firstname’, ‘lastname’, “postal code”, ‘city’, ‘country’, 'date_of_birth' (see Table 2 
above). If the ‘pay_from_email’ parameter is supplied, it will be used as the primary email address 
for the new Skrill account. 





Note: This form only accepts Latin-1 characters 
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o A ACME 


Skrill account sign up 


Name 
“John 


Country of residence 
| United Kingdom 


Address line 1 
|11 Payerstr St 


Payer 





Address line 2 (optional) 


| Payertown 


Postcode 


City 





| EC45MQ 


Payertown | 





=. 
10 | 12 || 1970 


Email address 


 jpayer@skrill.com 


Password 


CREATE ACCOUNT 


By clicking the button above you accept the Skrill 
Terms and Conditions and Privacy Policy 


Se 


Skrill 


Figure 7 Sign up page with pre-filled customer information 
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2.2.4 Skrill payment page (Step 3) 


The Payment page shows the payment amount and payment details along with tabs for all 
supported payment methods. The tabs shown under the Payment amount (in this case 1.00 Euro) 
will vary depending on the customer's country and the Payment methods selected. By default, only 
one payment option is provided, pay by Skrill Balance. You must contact merchant services to add 
additional payment methods. 


There are four main payment options: 


e Pay by Credit/Debit Card indicated by two card icons 

e Pay by Direct Debit / SEPA (Germany only) 

e Pay by Skrill Balance 

e Pay by Online Banking or Alternative Payment Methods 


These payment options are described in detail below. 


2.2.4.1 Pay by credit/debit card 


This option allows customers to pay using a credit or debit card they have registered with their Skrill 
account or to add and pay with a new card. 


Welcome A Customer | Logout 


A 


1. Dou J. ACME 


=D Skrill _sororr 
= | Balance BANKING 


VISA XX-8488 


New card 


PAY NOW 


Cancel 





Gee Skrill 


Symantec 


Figure 8: Customer clicks PAY NOW 
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Customers can click select an existing card, enter the CVV code and click Pay Now. Alternatively, 
they can click + New Card to add and pay with a new card. When the customer enters their card 
number in the Card number field, the card type is automatically detected, and the card logo is 
displayed (see Figure 9 below). 





o 


Card number 


5 es 


Expiry date Security code 


Figure 9: Brand displayed to the right of the Card number field 








The card will now be associated with the Skrill account for future use. 





Note: The new card cannot be used to upload funds to the customer's Skrill account without 
verification. 





To finish payment using a new card, customers enter the Expiry date and Security code for the card 
and click Pay Now. If the customer's card provider uses 3-D Secure, there will be additional prompts 
to enter these details. Once payment is complete, customers will be directed to the Skrill 
Transaction Status page as described below. 


Skrill provide the following test credit card details (Note that these card numbers can only be used 
with Test merchant accounts). 


Brand Card Number 


Visa 4000001234567890 


Mastercard 5438311234567890 


2.2.4.2 Pay by direct debit / SEPA (Germany only) 


German customers have the option to pay using SEPA Customers enter the IBAN and SWIFT details 
for their account and click Pay Now. Once payment is complete, customers will be directed to the 
Skrill Transaction Status page as described below. 
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Welcome Sample Payer | Logout 


5.00cer o A ACME 


Skrill 
Balance DEPA = 
Add a new bank account 


You have not set up any bank accounts. 


IBAN 


© 





SWIFT 


(>) 








PAY NOW 


Gips Skrill 


Figure 10: Pay by SEPA example 
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2.2.4.3 Pay by Skrill balance 


The customer selects the Skrill Balance tab. At any time before the final Pay Now button is selected, 
the customer can click Cancel to cancel the payment process and return to your website (to the URL 
provided in the 'cancel_url' field; see Table 2 on page 13). 


Welcome Sample Merchant | Logout 


5.00cs» J. ACME 


Skrill = RAAPI avoust 


Balance 


BALANCE 


170.440 


(132.71 GBP) 


PAY NOW 


Gips Skrill 


Figure 11 Payment confirmation for Skrill wallet 
If the customer has insufficient balance for the payment, they will be prompted to use another 
payment method. Once payment is complete, they will be directed to the Skrill Transaction Status 
page as described below. 


2.2.4.4 Pay by instant banking options or alternative payment methods 


Skrill supports several Instant Banking and Alternative Payment methods, such as POLI or 
Paysafecard. The available methods depend on the customer’s country of registration and the 
Payment methods configured for the merchant's account; see Section 6.7 for a list of payment 
methods and their availability. 


To use these methods, the customer must enter their account details and click the Proceed to 
button to go to the external website to complete payment. Once payment is complete, the customer 
will be directed to the Skrill Transaction Status page, as described below. 


2.2.5 Skrill transaction status page and return to merchant (Steps 4 and 5) 


When the payment process is completed, the “Successful Payment' message appears (see Figure 
12). The customer can now click Continue to go to the successful payment section of your website 
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specified in the return_url parameter. You can change the button text using the return_url_text 
parameter. lf the payment is unsuccessful then the customer is redirected to the cancel url page. 





Note: If the cancel url field is not filled, the customer is returned to the page on your website from 
where they were redirected to Skrill. 





Welcome John Payer | Logout 


15.00cer A ACME 


Y 





Successful payment 


Gips Skrill 


Figure 12 Transaction status page showing successful payment 


2.2.6 Skrill status response 


When the payment process is complete Skrill sends the details of the transaction to the “status url” 
page you provided (see Table 2 on page 13). This is done with a standard HTTP POST request. The 
Skrill server continues to post the status until a response of HTTP OK (200) is received from your 
server or the number of posts exceeds 10. Table 3 shows the parameters sent to your status_url 


page. 
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merchant_fields parameter, they will 
be passed back with the status report. 








Field Name Description Required Example value 
pay_to_email Your email address. Yes info@example.com 
pay_from_email Email address of the customer who is Yes payer@skrill.com 

making the payment. 
merchant_id Unique ID of your Skrill account. ONLY | Yes 100005 
needed for the calculation of the MD5 
signature (see section 6.4 on page 82). 
customer_id Unique ID of the customer’s Skrill No* 200005 
account. 
transaction_id A unique reference or identification No** A205220 
number provided by you in your HTML 
form. 
mb_amount The total amount of the payment in Yes 25.46 / 25.4 / 25 
the currency of your Skrill Digital 
Wallet account. 
mb_currency Currency of mb_amount. Will always Yes GBP 
be the same as the currency of your 
Skrill Digital Wallet account. 
status Status of the transaction: -2 failed / 2 Yes 2 
processed / O pending / -1 cancelled 
(see detailed explanation below) 
failed_reason_code If the transaction is with status -2 No*** 06 
(failed), this field will contain a code 
detailing the reason for the failure. 
md5sig MDS signature (see section 6.4 on Yes 327638C253A4637199CEBA 
page 82). 6642371F20 
sha2sig SHA2 signature (see section 6.5 on No**** dbb7101322257a311f08d1c 
page 83). 527053058fc7e464e30bcfb4 
613f09053c22dd1f8 
amount Amount of the payment as posted in Yes 39.60 / 39.6 / 39 
your HTML form. 
currency Currency of the payment as posted in Yes EUR 
your HTML form. 
merchant_fields If you submitted a list of values in the No field1=value1 





Notes 


* The customer_id parameter is enabled upon activation. If you don’t receive it in the response 
status, please contact merchant services. 

**If no transaction_id is submitted, the mb transaction id value will be posted in the report. 

*** The failed_reason_code parameter is enabled upon activation and is part of the response 
status. For a description of all failed reason codes, see section 6.8 on page 88. 

**** To enable the sha2sig parameter, contact merchant services. For more information, see 
section 6.5 on page 83. 

***** The payment_type parameter is enabled by merchant services. If you don’t receive it in 
the response status, please contact merchant services. 
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Validating the status response 


We recommend that you validate the transaction details in the status response. This can be done as 
follows: 


Create a pending transaction or order for a fixed amount on your website. 
Redirect the customer to the Skrill Wallet Checkout, where they complete the transaction. 

3. Skrill will post the transaction confirmation to your status url” page. This will include the 
'mb_amount' (amount) parameter. 

4. Your website should validate the parameters received by calculating the md5 signature (see 
section 6.4 on page 82). If successful, it should compare the value in the confirmation post 
(amount parameter) to the one from the pending transaction or order on your website. You 
can also compare other parameters such as “transaction id’ and “pay from email”. 

5. Once you have validated the transaction data you can process the transaction, for example, 
by dispatching the goods ordered. 





Note: If you want to restrict the receipt of status response based on the posting IP address, you 
should use the full list of Skrill IP ranges as from time to time Skrill may change the IP address 
used. Any address within any of the following listed ranges could be used. The full list of Skrill 
IP ranges is: 91.208.28.0/24, 93.191.174.0/24, 193.105.47.0/24, 195.69.173.0/24 





Using the Merchant Query Interface 


You can use the Merchant Query Interface to repost a status report or automatically check the 
status of a transaction. For details, see the Automated Payments Interface Guide. 


2.2.7 Detailed status description 


Table 4: Transaction status 


$ Status Description 





ada Processed Sent when the transaction is processed, and the funds have been received 
in your Skrill account. 





‘O’ Pending Sent when the customers pay via an offline bank transfer option. Such 
transactions will auto-process if the bank transfer is received by Skrill. 


Note: We strongly recommend that you do not process the order or 
transaction in your system upon receipt of this status from Skrill. 





“T Cancelled Pending transactions can either be cancelled manually by the sender in 
their online Skrill Digital Wallet account history or they will auto-cancel 
after 14 days if still pending. 





EEN Failed Sent when the customer tries to pay via Credit Card or Direct Debit but our 
provider declines the transaction. If you do not accept Credit Card or Direct 
Debit payments via Skrill you will never receive the failed status. 





EEN Chargeback Whenever a chargeback is received by Skrill, a ‘-3’ status is posted in the 
status_url and an email is sent to the primary email address linked to the 
Merchant's account. Skrill also creates a new debit transaction to debit the 
funds from your merchant account 
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2.3 Sales tax / VAT option 
Skrill provides a configuration setting to assist merchants to calculate sales / value added tax (VAT). 


Contact merchant services to enable this option. Once enabled, the following three additional 
parameters are sent as part of the status response to the status_urls. 


Table 5: Sales tax status_url parameters 





Parameter Description 





payment instrument country | A three letter ISO 3166-1 alpha-3 code showing the country of origin of 
the payment instrument the customer used. For example, a Visa card for a 
bank in Germany would return DEU. This value will be blank if no country 
can be determined for the payment method. If the customer pays using 
their Skrill Wallet balance, then the payment_instrument_country will be 
the same as the country registered for their Skrill account 





country A three letter ISO 3166-1 alpha-3 country code. If a country parameter is 
passed to the payment form this value will be used. If customer pays using 
a Skrill Wallet, then the country they selected when registering their Skrill 
account is returned. If none of these situations apply, then geolocation 
(using the customers IP) is used to return a 3-character country code. 





IP country A two letter ISO 3166-1 alpha-2 code showing the customer's country as 
determined by Geolocation using the customer's IP. 














These values are also added to the CSV account history report. This report can be obtained using the 
view account history Merchant Query Interface option or via the All Transactions > Export CSV 
option in the My account section after logging in to your merchant Skrill account. The following 
table shows the column names for these parameters in the CSV file: 


Table 6: CSV parameters 


Status url Parameter CSV column name 





payment instrument country Instrument Country 





country Country 














IP country IP country 





2.4 Test merchant 


You can use our test page at https://www.skrill.com/app/test payment.pl to access the payment 
form parameters. Set the pay to email parameter under Merchant Details to the test merchant 
account demowallet@sun-fish.com. Set any other parameters as required and click Submit to load 
the Wallet Checkout. 


Warning: This is the live production payment form. If you use a standard (non-test) pay to email 
merchant account and a valid credit card or standard Skrill wallet balance, then the payments 
will be processed and deducted from your card or Skrill wallet. 


2.5 Securing your Skrill merchant account 


It is important to secure your Skrill merchant in case your account password is compromised. Skrill 
provides several methods to enhance the security of your account: 


1. Restricting access to your Merchant account to a specific IP address or a list of IP addresses. 
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Google Two Factor Authentication using a Mobile device (Android or Apple devices are 
supported) 


The Skrill hardware security token 


Skrill recommend that you use methods 1 and 2 to secure your account. Alternatively, you can use 


methods 1 and 3. You cannot use the hardware token together with Google Two Factor 


Authentication. These methods are described in detail below. 


2.5.1 Restricting access to your merchant account by IP address 


This is only useful if your ISP provides you with a static IP address or addresses. If the machine(s) that 
you use to log in have dynamically allocated IP addresses you will not be able to use this method to 


secure your account. 


Configure this option as follows: 


1. 


Locate your IP address/addresses/address range used by the machines you wish to use to 
access your Skrill merchant account. 


Log in to your merchant account. 


Go to Settings > Developer Settings > API / MAI / GSR / CVT Management > Gateway 
Secure Restriction (GSR). 


Click Add and enter an IP address. 
Click Save 
Log out of your account. The restrictions are now active. 


Test that you can log in to your account from the machine/machines that you wish to use 
and that you unable to log in from a machine with a different IP address. 


Gateway Secure Restriction (GSR) Disabled D 





Warning: If you choose to restrict log in to an IP range, use the smallest possible address range. Do 


not specify a range larger than 256 IP addresses. 





© Skrill 2021 Page 32 


Skrill Wallet Guide 8.1 





3 CUSTOMIZATION OPTIONS 





3.1 Payment methods 


The payment_method parameter can be used to pass a payment method code to pre-select the 
default payment method for your customers (shown in the second payment tab) after login. Most of 
these codes are three characters long — for example DID — but the parameter can accept up to 100 
characters. If more than one payment method code is supplied, all except the first are ignored. 


Once a customer has logged in, all payment methods available in the country associated with their 
Skrill wallet account are displayed, ordered by popularity in the customer's country. For a list of 
currently supported payment method codes, see section 6.7 on page 86 . 


3.2 Reduced header option 


Skrill provides a Reduced Header option to reduce the size of the payment page. This is useful when 
embedding the payment form in an iframe. The Reduced Header option displays a minimal header 
without logo or payment details, see Figure 13 for an example. 

















Skrill Wallet 
1.00 EUR Welcome lan Test | Logout Y-——————— Checkout page 
F mí with header and 
Skrill => SoFo. l 
Balance | =D | aag Commie | payment details 
removed 
Add new card 
Card number 
Expiry date Security code 
Qe Skrill 
Figure 13 Hide header option 
This option is described in detail in the table below: 
Table 7: Payment Page Display Option 
Option Description Notes 
Reduced Header Shows a minimal header | Users cannot select a different language. The language the 
without a logo or customer chose when registering the account is shown. 
payment details. Users can see payment amount at all times but no payment 
details. 
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3.3 Recurring billing 
Skrill offers a tool for recurring payments, which is available as a stand-alone product or via the Skrill 


Wallet Checkout. In addition to the standard HTML form parameters (see Table 2 on page 13), you 
can supply the following parameters to set up a recurring payment: 


Table 8: Recurring billing parameters 


























Field Name Description Required S o Example value 

rec amount Amount of the recurring Yes/ No 19 19.90 
payment (to be taken at each 
recurring period) 

rec start date Start date of the period in No 10 01/08/2013 
DD/MM/YYYY format* 

rec end date Final date of the period in No 10 31/08/2014 
DD/MM/YYYY format 

rec period Period between payments Yes 6 14 

rec cycle Time period measure you No 5 day 
require — day/month/year. If 
this parameter is not submitted, 
Skrill assumes that the rec cycle 
is days. 

rec grace period You can set a period of days No 5 7 
during which the customer can 
still process the transaction if it 
originally failed. The value 
submitted is always in days. 

rec status url URL to which Skrill notifies you No 400 http://www.example.co 
that the recurring payment is m/rec payment cancell 
cancelled. ed.htm 

rec status url? Second URL to which Skrill No 400 http://www .example.co 
notifies you that the recurring m/rec payment cancell 
payment is cancelled. ed2.htm 























Notes 

* The rec start date parameter should not be set in the future for recurring credit card payments if 
amount is empty (no amount is charged immediately) 

Recurring billing setup options 

You can set up a recurring billing payment using one of the following options: 


Option 1 — Take an initial payment, followed by recurring payments for a different amount: 


Enter a specific amount (e.g., EUR 4.99) as the ‘amount’ parameter in your HTML form and a 
specific amount (e.g., EUR 19.90) as a rec amount. 
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Option 2 — Do not take an initial payment. Only set up the recurring payments: 


Leave the amount parameter empty (empty not zero) and only enter the rec_amount value. 


Payment methods used with recurring billing 
A recurring billing payment can be set up with one of the following payment methods: 


Credit/debit card (Visa and MasterCard) 
Direct Debit 
Customers” Skrill account balance 


Example code 


The code snippet below shows an example of the additional parameters included for a recurring 









































payment: 

<input type="hidden" name="rec amount" value="19.90"> 

<input type="hidden" name="rec start date" value="01/08/2013"> 
<input type="hidden" name="rec end date" value="31/08/2014"> 
<input type="hidden" name="rec period" value="14"> 

<input type="hidden" name="rec cycle" value="day"> 

<input type="hidden" name="rec grace period" value="7"> 
<input type="hidden" name="rec status url" 
value="http://www.example.com/rec pay cancel.htm"> 

<input type="hidden" name="rec status url2" 
value="http://www.example.com/rec pay cancel2.htm"> 











Recurring billing status 


If a recurring billing has been set up and you have provided a “rec status url in your HTML form, 
Skrill posts the transaction details of each payment to your “rec status url page. The following table 
shows the parameters to be received on your page: 


Table 9: Recurring billing status parameters 























Field Name Description Required Example value 
merchant id Unique ID of your Skrill account. ONLY needed Yes 100005 
for the calculation of the MDS signature (see 
section 6.4 on page 82). 
transaction id The reference or identification number you Yes A205220 
provided. 
status Recurring payment status: 2 processed/ -2 Yes 2 
failed 
rec payment id Recurring payment ID Yes 200005 
rec payment type Type of payment: ‘recurring’ or ‘Skrill 1-Tap’ Yes recurring 
md5sig MDS signature (see section 6.4 on page 82) Yes 327638C253A46371 
99CEBA6642371F20 
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Field Name Description Required Example value 





merchant_fields A comma-separated list of field names that No Field1, Field2 
are passed back to your status page when the 
payment is confirmed (see Table 2). 




















Using the Merchant Query Interface 


You can use the Merchant Query Interface to check the status, cancel or extend the end date of a 
recurring payment. For details, see the Automated Payments Interface Guide. 


3.4 Secure return_url option 


This option allows you to be certain that the customer has arrived at your return_url page by 
completing the payment process — and not by looking up the return_url value in the page source 
code and entering it into their browser. However, this function only guarantees that the customer 
has completed the payment process and not that the payment had been processed. 


If this feature is not activated, please contact merchantservices@skrill.com. 


You must submit the following parameters with each transaction: 


e return url 

e transaction id 

e secret word (this will be automatically submitted IF entered in the Settings > Developer 
Settings page in your Skrill account). 


Skrill will then add the following parameters to the return url: 


Table 10: Parameters returned with the return URL 











Parameter Description Example value 

transaction id The transaction id you submitted. A205220 

msid The MDS signature, with the following values: 730743ed4ef7ec631155f5e1 
5d2f4fa0 


merchant_id e.g. 123456 
transaction_id e.g. A205220 


uppercase MDS value of the ASCII equivalent of your 
secret word, e.g. F76538E261E8009140AF89E001341F17 

















Below are two examples of the secure return_url, using the values above: 


Example 1 

Merchant submits return_url without additional parameters. For example: 
https://example.com/return_url.cgi 

In this case Skrill will redirect the customer to: 


https://example.com/return_url.cgi?transaction_id=A205220&msid=730743ed4ef7ec631155f5e15d 
2f4fa0 
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Example 2 


Merchant submits the return_url with additional parameters. For example: 
https://example.com/return_url.cgi?par1=val1&par2=val2 
In this case Skrill will redirect the customer to: 


https://example.com/return_url.cgi?par1=val1&par2=val2&transaction_id=A205220&msid=730743 
ed4ef7ec631155f5e15d2f4fa0 


3.5 Merchant refunds 


This option enables you to refund a payment back to the customer's Skrill account, credit/debit card 
or bank account (depending on the original payment method used). 





Note: Manual and Automated Refunds are not available for Gambling and Forex merchants. 





If this feature is not activated, please contact merchantservices@skrill.com. 





Note: If your account is configured to allow refunds, you will have an additional action link in the 
transaction history next to each entry that will trigger a refund to the customer. 





You can also make refunds through Skrill's Automated Payments Interface (API). For details, see the 
Automated Payments Interface Guide. 


3.6 Chargeback notification 


When Skrill receives a chargeback request from our provider, we will send a chargeback notification 
to your status_url page. This is indicated by a status of -3. (For a description of transaction statuses, 
see Table 4 on page 30.) 


3.7 Adding a descriptor 


When a customer pays through Skrill, Skrill submits a descriptor with the transaction, containing 
your business trading name/brand name. The descriptor is typically displayed on the bank or credit 
card statement of the customer. If you want to change this descriptor, please contact 
merchantservices @skrill.com. This functionality is only available for the following payment methods: 


e Visa 

e MasterCard 
e Klarna 

e Direct Debit 
e ¡DEAL 





Note: This feature is not available for cards from out-of-region banks. 





For Klarna and Direct Debit, you can also submit an additional payment form parameter, 
dynamic descriptor, which will override the default value stored by Skrill. 
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3.8 Displaying the Skrill Wallet Checkout in an iframe 


define in which frameset the return_url and cancel_url pages should be opened upon a successful 
payment or cancellation by the customer. 


Figure 14 shows an example of the gateway displayed in an iframe. 


Merchant Website Header area 
Return to main website é English 


E Skrill account 


Email address 


Password 


LOGIN 650 pixels 


Don't have an account? Sign up 


A A 


wa GE E = & 


Cancel 


VS Skrill 


Merchant Website Footer area 


Figure 14 Wallet checkout displayed in iframe 


The size of the iframe should be 450px by 650px (including the Gateway header and footer). Note 
that the vertical height required is reduced if using the Hide Header option, see section 3.2 for 
details. The minimum vertical height will increase for 1-Tap payments to accommodate the 1-Tap 
information banner. 


This option is implemented by submitting two additional parameters in your HTML form: 
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M 
Field Name Description Values e Default Example 
length 
return url target | Specifies the target in which the 1=' top' 1 1 3 
return url page will be displayed 2='" parent 
upon successful payment 3=" self 
AT blank 
cancel_url_target | Specifies the target in which the 1=' top' 1 1 3 
cancel_url page will be displayed 2 ='_parent' 
if the customer cancels the i ; 
3=' self 
payment. = 
4='_blank' 





Table 12: iframe targets 


























Value | Equivalent Description 

1 ' top’ Opens the target URL in the full body of the window - the URL contents fills the 
entire browser window. 

2 ' parent' Opens the target URL in the parent frame. 

3 '_self' Opens the target URL in the same frame. Using "_self" has the same effect as not 
using iframe target at all. 

4 ' blank Opens the target URL in a new browser window. 





3.9 Code integration examples 


You can use the examples below to generate your session ID from Skrill, which is the recommended 
method for connecting to the Skrill Wallet Checkout, as described in section 2.2.2 on page 19. 


3.9.1 Generating the session identifier 


Below are examples of how to generate a SID using different programming methods: 


CURL 








curl -X POST https://pay.skrill.com 








-d "pay to email=merchant emailêmail.com" 
-d "amount=10.99" 
-d "currency=EUR" 
-d "language=EN" 
-d "prepare only=1" 
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Ruby 








require 'net/http 











require 'net/https' 
require 'uri' 


uri = URI('https://pay.skrill.com') 
http = Net: :HTTP.new(uri.host, uri.port) 








http.use _ ssl = true 

req = Net::HTTP::Post.new(uri.path) 
reg.set form data ({ 

'pay to email'=>'merchant_emailfimail.com', 
"amount'=>'10.99', 

"currency'=>'EUR', 











'language'=>'EN', 
"prepare only'=>'1' 


}) 
res = http.request (req) 
puts res.body 





3.9.2 Redirecting the customer to Skrill 


Once you have the session identifier (SID), you then have to redirect the customer to Skrill, including 
the session identifier. 


https://pay.skrill.com/?sid=<generated_sid> 


Where <generated_sid> is the SID returned by Skrill. 


You can open the URL with the SID as a light box or in an iframe. 
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4 SKRILL 1-TAP PAYMENT 





Skrill offers a single-click payment service which enables you to automatically debit transactions 
from your customer”s Skrill account without the customer having to log in to their account and 
authorise each time. 


Customers are sent an email notification after each 1-Tap payment and they can view the status of 
all their Skrill 1-Tap payments in the History section of their Skrill Wallet account. 


Customers can pay using Skrill 1-Tap with any of the following payment methods linked to their Skrill 
account: 


e Credit/debit card (Visa and MasterCard) 
e Direct Debit 
e Skrill account balance 


4.1 Enabling 1-Tap 
To enable this service, contact merchantservices@skrill.com. 





Note: You must set up a separate merchant account for taking Skrill 1-Tap payments. 





4.2 Enable the MQI and API 


You will need to enable the MQI (merchant query interface) and API (automated payment interface) 
and set up an MAI / API password to use 1-Tap. You can also change the MQI/API password here in 
this section. 


To enable the MAI and / or API: 


Log in to your Skrill account at www.skrill.com. 

Go to Settings > Developer Settings > API / MAI / GSR / CVT Management. 

Set the API / MQI Password and click Save to confirm. 

Specify at least one IP address from which requests will be made. All requests from other IP 


P wo nm A 


addresses are denied. Access can be granted to: 

e Asingle IP address (e.g. 192.168.0.2) 

e Multiple IP addresses separated by space (e.g. 192.168.0.2 10.0.0.2) 
e Asubnet in CIDR notation (e.g. 175.10.10.252/30) 





Warning: CIDR ranges should not be longer than 256 IP addresses. 








Note: If the Settings > Developer Settings section is not displayed in your account, contact Skrill 
Merchant Services. 





5. To apply your changes, click Save. 
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Set API / MQI Password Enabled 


Figure 15 Enable the API and MOL and setup a password and IP range for these services 
You must use a separate password for making API or MQI requests. This ensures that the password 
you use to access your Skrill Digital Wallet account can be changed without affecting the API or MOL. 


To enable an API/MQI password: 


1. Locate the Settings > Developer Settings > Change MOL / API password area 
2. Enter a new password and confirm it in the Re-type password field below. 
3. To apply your changes, click Save. The MQI and API are now enabled. 





Note: The password must be at least 8 characters long and must contain at least one alphabetic and 
one non-alphabetic character. 





The MAI is used for the following functions: 


e Repost transaction status information for payment transactions (Wallet / Quick checkout 
payments and 1-Tap subsequent payments) 

e View transaction status (payment and send money transactions) 

e View account history 

e Cancel a recurring payment 

e View the status of a recurring payment 

e Extend the end date of a recurring payment 

e Cancel a1-Tap payment 

e View the status of a 1-Tap payment 


The API is used for the following functions: 


e Refund Quick Checkout / Wallet Checkout / 1-Tap payments. (This functionality is not 
available for Gambling and FOREX Merchants) 

e Transfer Money to another Skrill Account (send money). 

e Taking subsequent 1-Tap payments (after the initial setup payment) 


4.3 Skrill 1-Tap button 


The Skrill 1-Tap button must be displayed on your website when setting up Skrill 1-Tap mandates as 
well as with any subsequent transactions performed through Skrill 1-Tap. 


Skrill 1-Tap™ | 
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This button is available in different sizes. For details, see: 


https://www.skrill.com/en/business/merchants/brand-centre 


4.4 Call flows 


The figures below provide a description of the 1-Tap payment setup process. 


Initial payment request with 1-Tap authorization 


a de 


Customer Merchant 





9,142.42 





Skrill Wallet Checkout 
g= Skrill 


Figure 16 Initial Skrill 1-Tap payment flow 


1. When the customer is ready to pay for goods or services on your website, they select the 
Skrill 1-Tap button on your website. 


2. You request a session identifier (SID) by passing customer and transaction details (e.g., 
amount, currency and language) to the Skrill Wallet Checkout. You also include the required 
1-Tap parameters. 


3. Skrill returns the generated SID. 


4. Using a light box or iframe you redirect the customer to the Skrill Wallet Checkout and 
include the session identifier in the redirect URL. Skrill displays the payment page. 


5. The customer logs in to their account where they can view the 1-Tap transaction details, 
select a 1-Tap payment method and confirm the transaction. 


6. Skrill requests authorisation for the payment from the customer's bank, third party provider 
or card issuer. 


7. The bank/provider approves or rejects the transaction. 
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8. Skrill displays the confirmation page, containing the transaction result, on the Skrill Wallet 
Checkout. 


9. Skrill provides you with an asynchronous notification, sent to your status URL or IPN (instant 
Payment Notification), confirming the transaction details and status. These details include 
the rec_payment_id of the 1-Tap payment, which can be used for future 1-Tap debits from 
the customer's account. 





Note: You should keep track of the status of 1-Tap payment and update your records if notified of a 
status change at the ondemand_status_url you submitted for the 1-Tap payment. 





Subsequent 1-Tap payments 


; Em — 
A = 
j 
1 


Customer A — Merchant 





Skrill Payment Platform 


(1-Tap section of Automated 
Payment Interface) 





Figure 17 Subsequent 1-Tap payment flow 


1. The customer clicks the Skrill 1-Tap button. 


2. The merchant checks the status of the 1-Tap mandate in their records or through the 
Merchant Query Interface (MQI). 


3. Ifthe customer is already set up for 1-Tap, the merchant makes the Prepare request. Both 
frn trn id and rec payment id should be provided. 





Note: If the customer is not set up for 1-Tap, then the merchant makes a normal Wallet Checkout 
payment request and optionally submits 1-Tap payment details to set up the 1-Tap service, as 
described previously in Figure. 





4. The Skrill 1-Tap Payment Interface returns the session identifier (SID). 
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5. The merchant sends the execution request with the returned SID. 


6. The Skrill 1-Tap Payment Interface validates the request. 
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7. Skrill requests authorisation for the payment from the customer's bank, third party provider 


or card issuer (if required). 


8. The bank/provider approves or rejects the transaction. 


9. The Skrill 1-Tap Payment interface sends a response with the transaction status. 


10. Transaction status notification is also posted to the merchant's status URL. 


11. The merchant notifies the customer of the status of the 1-Tap payment. 


4.5 Setting up an initial 1-Tap payment 


In addition to the standard parameters described in Table 2, you can supply the following 


parameters to set up a Skrill 1-Tap payment via the Skrill Wallet Checkout: 


Table 13: Skrill 1-tap parameters 





Field Name 


Description 


Required 


Example value 





ondemand_max_amount 


Maximum amount for 
future payments that will 
be debited from the 
customer's account 


Yes 


11.50 





ondemand_max_currency 


ondemand_note 


3-letter code of the 
currency of the maximum 
amount according to ISO 
4217 (see section 6.1 on 
page 77) 


Text shown to the 
customer in the payment 
confirmation email as the 
reason for the Skrill 1-Tap 
payment. 


Yes/ No 


Yes 


EUR 


credit topped up 





ondemand_status_url 


URL to which Skrill notifies 
you that the Skrill 1-Tap 
payment is cancelled. 


This URL is restricted to the 
same ports as the 
status_url 


No 


http://www.exampl 
e.com/od payment 
cancelled.htm 





ondemand status url? 








Second URL to which Skrill 
notifies you that the Skrill 
1-Tap payment is 
cancelled. 


This URL is restricted to the 
same ports as the 
status_url 





No 





http://www.exampl 
e.com/od payment 
cancelled2.htm 
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If ‘ondemand_max_currency’ is not provided, the currency value will be the one provided as the 
“currency? in the standard HTML form (see Table 2 on page 13). 

A session identifier (SID) parameter is returned upon success. 

The Skrill response includes a rec payment id. You should store the rec payment id field so 
that you can reference the original 1-tap transaction. 

You can track the status of any 1-tap transaction and perform refunds using your own unique 
transaction id for that transaction. 


4.5.1 Example of a Skrill 1-Tap payment form 


See the example below. The included 1-Tap payment fields are highlighted. 








<form action="https://pay.skrill.com" method="post" target="_blank"> 


<in 
<in 
value 





lO "O 
3G 
D q 
ct 


<in 
<in 
<in 
<in 
<in 





IO SO too do 
SCHEER 


<in 








<input 

<inpu 

<inpu 

<inpu 

val 

<inpu 

val 
<input 

</form> 

















type="hidden" n 
type="hidden" n 
type="hidden" n 
type="hidden" n 
type="hidden" n 
type="hidden" n 
type="hidden" n 
type="hidden" n 
t type="hidden" 
t type="hidden" 
ue="www.exampl 
t type="hidden" 
ue="www.exampl 





ame="pay to email" val 
ame="status url" 


tps://www.example.com/status"> 


ue="demowallet@sun-fish.com"> 





EN"> 





ame="language" value=" 





ame="amount" value="39 





.60"> 





ame="currency" value="GBP"> 





ame="detaill description" value="Description:"> 





ame="detaill text" value="Romeo and Juliet"> 


= 


ame="recipient description" value="ACME Solutions"> 





type="hidden" name="ondemand max amount" value="150.00"> 








t type="hidden" name="ondemand max currency" value="EUR"> 


name="ondemand note" value="Your 1-Tap Payment"> 


name="ondemand status 
.com/ondemandstatus1"> 
name="ondemand_status 
.com/ondemandstatus2"> 


type="submit" value="Pay!"> 


4.5.2 Customer setup experience 


CURLI 


_url2" 


Figure 18 shows an example of the customer’s view before they log in to their Skrill account to pay 


and activate 1-Tap for subsequent payments. Note that a 1-Tap information bar is shown at the top 


of the standard payment form to keep customers informed at all times. Customers can click the ? 


icon in the bar to see further information. Once they have logged in, they are prompted to choose a 


payment method for this and future 1-Tap payments, see Figure 19. Finally, Figure 20 shows a 


successful payment with a message to inform the customer that 1-Tap is now setup for future 


payments. 
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& English 


Next time pay in a single tap, without 
Continue to enable 1-Tap for ACME Solutions ? leaving ACME Solutions. You can 


cancel at any time in your account 
23. Usus o A ACME 





ss OOho— 


New look! (Learn more) 
Skrill account 


Email address 
john.payer@skrill.com 


Password Forgot? 


LOGIN 


Don't have an account? Sign up 


Pay safely with just an email and password. 
wen SO E = re 


Cancel 


Gio Skrill 


4 


Figure 18 1-Tap setup Login page with hint message 
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Welcome John Payer | Logout 





Your chosen method will be used for 
this and future 1-Tap payments. 


——— 





5.001 © AMME 
SH E 





BALANCE 


9,287.42 


PAY NOW 


Cancel 


Ges) Skrill 


4 


Figure 19 Select 1-Tap payment method with hint message 
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& English 


1-Tap enabled - next time pay in a single tap 





9. OOEUR A ACME 


Y 





Successful payment 


Powered by 


Skrill 


Figure 20 1-Tap successful payment page 


4.6 Taking subsequent 1-Tap payments 


Once a Skrill 1-Tap payment has been set up, you must use the Skrill 1-Tap Payment Interface (part 
of Skrill’s Automated Payment Interface) to make individual requests to debit the customer”s Skrill 

account. If you have provided a “status url” value in your HTML form, Skrill will post the transaction 
details of each payment to that URL. 


Connecting to the 1-Tap interface 


You can connect to the Skrill 1-Tap interface by sending HTTPS GET / POST requests to: 


https://www.skrill.com/app/ondemand_request.pl 


Notes 


e You must enable the Skrill Automated Payment Interface (API) and setup an MQI/API 
password 

e Skrill recommend using POST for maximum security. 

e Do not mix GET and POST requests. Choose which method to use and apply consistently. 

e POST parameters are encoded using Content-Type: application/x-www-form-urlencoded 

e GET parameters are encoded in the URI query string using €: delimiters e.g. GET parameters 
are sent as part of the URL query string 
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1. Senda first request with action set to prepare to receive a session id for step 2 


2. Senda second request with action set to request using the session id from step 1 to execute 


the payment 


These steps are described in more detail below. 


4.6.1 Prepare payment step 


Action parameter: action=prepare 


This action prepares the transaction that will be executed later using the request action. The 


following parameters are required: 


Table 14: Parameters to include with the prepare request 





















































Field Name Description Required Example 
value 
email The email address linked to Yes Info@example. 
your Skrill account com 
password The lowercase hex MD5 of your | Yes 9f535b6ae672f 
API/MQI password 627e4e5f79f2b 
7c63fe 
action The required action (i.e., Yes prepare 
prepare”). 
amount Amount of the request for a Yes 10.50 
debit transaction. 
currency 3-letter code of the currency Yes EUR 
you wish to debit according to 
ISO 4217 
ondemand note Text shown to the customer in No Credit topped 
the confirmation email as the up 
reason for the Skrill 1-Tap 
payment. 
frn trn id Your transaction ID, used for Yes A205220 
the payment. This is your own 
unique reference for this 
transaction 
rec payment id Recurring payment ID Yes 200005 
(rec payment id value) sentto 
your status url page when you 
created the Skrill 1-Tap 
payment. 
merchant fields A comma-separated listoffield | No Field1, Field2 
names that are passed back to 
your web server when the Skrill 
1-Tap payment is confirmed 
(maximum 5 fields) 
Field1 An additional field you can No Valuel 
include, containing your own 
unique parameters. 
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E l 
Field Name Description Required ORS 

value 
Field2 An additional field you can No Value2 


include, containing your own 
unique parameters. 




















Notes 


e Both frn_trn_id and rec_payment_id should be provided. You should use the 
rec_payment_id field to reference the original 1-Tap transaction and provide a unique 
frn_trn_id as the reference for the current transaction. 

e Ifondemand note is not provided, the one that is submitted when creating the Skrill 1-Tap 
payment will be used. 


e A session identifier (SID) parameter is returned upon success. 
You can track the status of any 1-Tap transaction and perform refunds using the unique frn_trn_id 
for that transaction. 
Skrill response 


Skrill returns an XML response to your prepare request which contains a 'response' tag with one of 
the following elements: 


e 'sid' element - returned if the authorisation and payment preparation is successful. The SID 
(Session Identifier) must be submitted in your transfer execution request. 

e ‘error’ element — included if an error occurs. It includes an 'error_msg' tag, which contains 
the error message description. 


Example 1: Successful prepare request 
Below is an example of a successful prepare request: 


Request: 

POST https://www.skrill.com/app/ondemand_request.pl 
Header 

Content-Type: application/x-www-form-urlencoded 


Body 











mail=sample.merchant%40sun- 
fish.com&password=fb0dc09bd0989fe975afd3e4ddabb926&action=prepare&amount=1. 
23&currency=EUR&ondemand note=ondemand+notesfrn trn id=12341990grec payment 
_id=1668618647 











Response: 





<?xml version="1.0" encoding="UTF-8"?> 
<response> 
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<sid>4414c2a969c744c27bd674a0b0a5ba8a</sid> 
</response> 





Example 2: Failed prepare request 

This example shows a request that failed, due to an invalid merchant email. 
Request: 

POST https://www.skrill.com/app/ondemand request.pl 

Header 

Content-Type: application/x-www-form-urlencoded 


Body 





email=&password=fb0dc0 9bd0989fe975afd3e4ddabb926&action=prepareéamount=1.23 
&currency=EUR&ondemand_note=ondemandtnoteé&frn_ trn id=12341990&rec payment i 
d=1668618647 











Response: 








<?xml version="1.0" encoding="UTF-8"?> 
<response> 
<error> 
<error msg>LOGIN INVALID</error msg> 
</error> 
</response> 


Table 15: General Errors 








Error Description 





SESSION_EXPIRED Session has expired. Session IDs are only valid for 15 minutes 














Table 16: Errors when making Skrill 1-Tap payment requests 


























Error Description 

CUSTOMER_IS_LOCKED The customer's account is locked for outgoing payments 
BALANCE_NOT_ENOUGH The customer's account balance is insufficient 
RECIPIENT_LIMIT_EXCEEDED The customer's account limits are not sufficient 
CARD_FAILED The customer's credit or debit card failed 

REQUEST_FAILED Generic response for transaction failing for any other reason 
ONDEMAND_CANCELLED The customer has cancelled this Skrill 1-Tap payment 
ONDEMAND_INVALID The Skrill 1-Tap payment requested does not exist 
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MAX_REQ_REACHED 


Too many failed Skrill 1-Tap payment requests to the API. For security 
reasons, only two failed attempts per user per 24 hours are allowed 





MAX_AMOUNT_REACHED 








The payment amount is greater than the maximum amount 
configured when 1-Tap payments were setup for this user. 





Table 17: Errors when validating parameters 





Error 


Description 





INVALID_OR_MISSING_ACTION 


Wrong action or no action is provided 





LOGIN_INVALID 


Email address and/or password were not provided 





INVALID_REC_PAYMENT_ID 


Invalid recurring payment ID is submitted by the merchant 





MISSING_EMAIL 


Provide registered email address of merchant account 





MISSING_PASSWORD 


Provide correct API/MQI password 





MISSING_AMOUNT 


Provide amount you wish to send 





MISSING_CURRENCY 


Provide currency you wish to send 





MISSING_BNF_EMAIL 


Provide email address of the beneficiary 





MISSING_SUBJECT 


Provide subject of the payment 





MISSING_NOTE 








Provide notes for the payment 





4.6.2 Execute payment step 


Action parameter: action=request 


Now that you have received a session ID you can execute the actual payment transaction using the 


request action. The URL is the same as before. The following parameters are required: 


Table 18: Parameters to include with the request 

















Field Name Description Required Example value 

sid Session identifier returned in response to the Yes 7783bfa23641a627e4a5f 
prepare request. 79f2b7c6 

action The required action (Le, prepare”). Yes request 











Upon success, Skrill returns the details of the transaction as an XML response. This response 


contains the following fields: 


Table 19: Fields provided in the XML response 





























Field Name Description Example value 
amount Amount requested 10.50 
currency 3-letter currency code of the amount, according to ISO 4217 EUR 
id Transaction ID 500123 
status Skrill 1-Tap payment status: 2 
2 — processed 
-2 — failed 
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Field Name Description Example value 
status_msg Text description of the status. processed 
Notes: 


e Ifa request fails, you are not allowed to make more than two requests for a debit of a 
customer's account using a Skrill 1-Tap payment per customer per 24 hours. 


e The customer is notified via email for every Skrill 1-Tap payment request executed. 
Example 3: Successful prepare request 
Below is an example of a successful request: 
Request: 
POST https://www.skrill.com/app/ondemand_ request. pl 
Header 
Content-Type: application/x-www-form-urlencoded 


Body 


sid=84034fe3e5c9f6ef54e5lefbbe9f2767gaction=request 


Response: 











<?xml version="1.0" encoding="UTF-8"?> 
<response> 
<transaction> 
<amount>10.34</amount> 








<currency>EUR</currency> 
<id>1668624876</id> 
<status>2</status> 
<status_msg>processed</status_msg> 








</transaction> 
</response> 











Example 4: Failed request 
This example shows a request that failed, due to an expired session id. 
Request: 


POST https://www.skrill.com/app/ondemand request.pl 
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Header 


Content-Type: application/x-www-form-urlencoded 


Body 








sid=1238action=request 





Response: 








<?xml version="1.0" encoding="UTF-8" ?> 
<response> 
<error> 
<error msg>SESSION EXPIRED</error msg> 
</error> 

















</response> 





4.7 Checking or cancelling 1-Tap payments 


You can use the Merchant Query Interface (MAI) to review the status of a 1-Tap payment or to 
cancel it so that no more 1-Tap payments can be taken. 


You can access the MAI by posting an HTTPS GET/POST query to: 
https://www.skrill.com/a uery.pl 


The MQI requires three general parameters to be included in your query (email, password and 
action) and a number of parameters specific to the requested action (see the Additional Parameters 
table for each action below) 


Table 20 General parameters 























Field Name Description Required Example value 

email The email address linked to Yes Info@example.com 
your Skrill account 

password The lowercase hex MD5 of your | Yes 9f535b6ae672f627e4e5f 
API/MQI password 79f2b7c63fe 

action The required action (i.e., Yes status_od 
‘prepare’). 

amount Amount of the request for a Yes 10.50 


debit transaction. 




















4.7.1 Cancel Skrill 1-Tap payment 
Action parameter: action=cancel_od 


This action allows you to cancel a Skrill 1-Tap payment. The following additional parameter is 
required: 


Table 21: Additional parameters - cancel a 1-Tap payment 





Field Name Description Required Example value 
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trn_id Your transaction ID. This is the transaction_id value | Yes 500123 
you provided for the initial setup 1-Tap payment. If 
you did not provide a transaction_id parameter 
this will be the transaction_id parameter returned 
to your status_url page once the initial setup 1-Tap 
payment is complete 




















Request: 


POST https://www.skrill.com/app/query.pl 


Header 


Content-Type: application/x-www-form-urlencoded 


Body 











action=cancel od&email=infoltexample.comapassword=9f535b6ae672f627e4a5f7/9f2b 
1c63fe&atrn id=500123 





Response: 








200 > > OK 





Where an arrow symbolises a tab character. 
Using Escape Sequences to represent special characters: 


200\t\tOK\n\n 


4.7.2 Get Skrill 1-Tap payment status 


Action parameter: action=status_od 


This action allows you to check the status of a Skrill 1-Tap payment. The following additional 
parameter is required: 


Table 22: Additional parameters - 1-Tap status check parameters 








Field Name Description Required Example value 





trn_id Your transaction ID. This is the transaction_id value you Yes 500123 
provided for the initial setup 1-Tap payment. If you did 
not provide a transaction id parameter this will be the 
transaction_id parameter returned to your status_url 

page once the initial setup 1-Tap payment is complete 




















If a transaction with the supplied ID is found, the response will contain the following parameters on 
the second line of the response: 


e Status: O- active; -1 — cancelled 


e Last execution date in dd-mm-yyyy format or -- if no subsequent payments have been taken 
(payments after the initial setup). 
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Example 6: Check status of a cancelled 1-Tap payment 


Request: 


POST https://www.skrill.com/app/query.pl 


Header 


Content-Type: application/x-www-form-urlencoded 


Body 





action=status od&email=infoltexample.com&apassword=9f535b6ae672f627e4a5f7/9f2b 
1c63fe&atrn id=500123 








Response: 








200 > > OK 
Status: -1 Last execution date: 08-01-2017 








Note: The arrows above represent tab characters. There are two spaces between the Status value 
and the word last. 





Using Escape Sequences to represent special characters: 


200\t\tOK\nStatus: -1 Last execution date: 08-01-2017\n 


Example 7: Check status of an active 1-Tap payment with no subsequent payments 


Request: 


POST https://www.skrill.com/app/query.pl 


Header 


Content-Type: application/x-www-form-urlencoded 


Body 








action=status od&email=infoltexample.comapassword=9f535b6ae672f627e4a5f7/9f2b 
1c63fe&atrn id=500123 





Response: 








200 > > OK 
Status: O Last execution date: E 





Using Escape Sequences to represent special characters: 


200\t\tOK\nStatus: -1 Last execution date: --\n 


Example 8: Check status of an active 1-Tap payment with invalid transaction 


Request: 


POST https://www.skrill.com/app/query.pl 
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Header 


Content-Type: application/x-www-form-urlencoded 


Body 





action=status od&email=infoltexample.comapassword=9f535b6ae672f627e4a5f7/9f2b 
1c63fe&trn id=123 








Response: 











403 = = Transaction not found: 123 





Using Escape Sequences to represent special characters: 


403\t\tTransaction not found: 123\n 





Note: The above response still returns a 200 HTTP response status code 





4.7.3 MQl error messages 


The following error messages can be returned by the Merchant Query Interface: 


Table 23: MQI error messages 














Error Description Reason for Error 

401 Unauthorised/ Cannot log in Authentication is required and has failed or has not yet been 
provided. 

402 Payment Required Reserved for future use. 

403 Forbidden The request was a valid request, but the server is refusing to 


respond to it. For example, the provided credentials were 
successfully authenticated but do not grant the client permission 
to access the resource. 





404 Not Found The requested resource could not be found. 





405 Method not Allowed A request was made of a resource using a request method not 
supported. For example, using GET on a method which requires 
data to be presented via POST. 
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5 ASTROPAY 





This section explains the Skrill payment flow for the Astropay payment method available in 
Argentina, Brazil, Chile, Colombia, Mexico, Peru, and Uruguay. Astropay is composed of two 
subcategories: 


Bank Transfer (two types are available: Direct or Manual) 
Cash / Invoice 





Note: Astropay is only available for payments of greater than or equal to 10 USD. Contact Skrill 
Merchant Services to enable each of the different Astropay payment methods listed above. 





These categories are described in more detail below. Not all categories are supported in all the 
countries where Astropay is available, see List of Banks Supported by Country for a list of all the 
Banks or Cash payment networks that Astropay supports in each country and which payment 
category they support. If a country is not listed, then it does not support Astropay. 


Astropay integration is the same as the standard Skrill integration however the merchant’s 
integration code must handle interim pending payment status notifications and be prepared to 
receive the final payment success notification some days, weeks or months later (in the case of 
cash/invoice payment). 


The Skrill Wallet Checkout payment form can show two Astropay tabs: Cash and Bank Transfer. The 
Bank Transfer tab is used for both Direct and Manual bank transfer. When a customer selects the 
appropriate tab, they will see the logos of all supported Banks (or in the case of Cash, supported 
Payment Networks) and a drop-down menu where they can select the Bank or Payment Network 
they wish to use. If only one Bank or Payment Network is supported in the customer's country, then 
this logo will appear instead of Cash or Bank Transfer to increase conversion. 


If the merchant passes a payment method code, they can restrict the Bank Transfer page to only 
show Direct or Manual banks in the drop-down menu on the Bank Transfer tab as appropriate. 


Finally, this section includes a description of the refund process which differs from the standard 
refund process as user action is required. 
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5.1 Bank transfer 


5.1.1 Direct bank transfer 


This is the simplest method for customers. The payment flow is as follows: 


1. 


The customer clicks Pay by Bank Transfer on the merchant website and is redirected to the 
Skrill Wallet Checkout payment form. Note that the payment form can also be displayed in 
an iframe. 


The customer enters their National Identity number (this field has a different name 
depending on the country e.g., CPF, RUT, ID, DNI, etc.) 


The customer selects a local bank in the Skrill payment form and clicks Proceed to Online 
Bank. The list of available banks depends on the country selected. If the bank supports 
Direct Bank Transfer, then the payment flow continues, otherwise the flow will be as 
described in Manual Bank Transfer below. 


The customer is redirected to the chosen bank's website where they can login and approve a 
bank transfer to make payment. 


Once payment is complete, Skrill shows a successful payment form and sends a response 
containing the payment status to the merchant's status url. 


The customer clicks the button on the success form to return to the merchant website. The 
merchant website should check the payment status received at the status_url for the 
payment to determine the message to show to the customer. 


When the merchant receives a valid payment confirmation with a status value of 2 at the 
merchant's status url they can release the goods to the customer. 
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Welcome Emanual Sanchez | Logout 


30.00us9 o =A ACME 


Skill izgs cum 
Balance 
pme- m . 


Bank transfers are confirmed instantly. Your 
payment can be processed immediately using 
your online bank credentials 














Bank 

Banco do Brasil v 
CPF 

10934510213 
Email address Why? 


emanual_sanchez@paysafe.com 


You will be redirected to your online bank to complete this 
payment 


PROCEED TO ONLINE BANK 


(Via Skrill 


Figure 21 - Direct bank transfer step 1 - enter name and ID number and select a bank 
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Comércio Eletrónico - Meios de Pagamento 


Você está efetuando uma transação no site do Banco do Brasil que permite o 
pagamento de produtos, serviços ou obrigações disponibilizados via Internet. 





Loja Conveniada : ASTROPAY BRASIL 
Referência da Transação : 25.167.530.009.428.042 
Valor Total : 119,60 





Selecione a sua opção de pagamento: 


Figure 22 - Direct bank transfer step 2 - select business or personal bank account 











Autoatendimento 
Mulas: Como acessar? 
ee > Náo possui ou esqueceu sua senha? 
Agência: Conta: > Requisitos mínimos 
> Termo de uso do autoatendimento 
1518-0 25718-4 
Senha de autoatendimento (8 dígitos): Outros acessos 
Hen 
> Deficiente Visual 
Caso não possua senha, clue aqui > Utilizando certificado digital A3 
| ENTRAR i LIMPAR | Suporte Técnico 0800 729 0200 
Entrar 


Senha de Aúto-Atendimento: Conteúdo deve ter no mínimo 8 caracteres.... 


W Serviço de Mensagens via q BB Conta de Pagamento 
4 E Celular(SMS) o aA Faça transferências até para quem 
. Mais seguranga e conveniéncia. GW não tem conta no BB. 

> Saiba mais > Saiba mais 


Figure 23 - Direct bank transfer step 3 — log in to the bank to make a transfer 
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Confira os dados do seu pedido e confirme 
seu pagamento 


ASTROPAY BRASIL 
25167530003038140 





Figure 24 - Direct bank transfer step 4 - re-enter your password 


ASTROPAY BRASIL 
25167530003038140 
2,60 


1518-0 

25718-4 

KELLI ANDRESSA 
RIBEIRO PINTO 
13/08/2014 


Autenticação SISBB: 978577 


Transação efetivada com sucesso! 


[ CONFIRMAR O PAGAMENTO NA LOJA i 1 IMPRIMIR | 





Figure 25 - Direct bank transfer step 5 - review payment details and confirm payment 
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& English 


30.00" o AMME 


Y 





Successful payment 


The transaction will appear on your bank statement as 
Online payment. 


Figure 26 - Direct bank transfer step 6 - successful payment 
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5.1.2 Manual bank transfer 


The manual bank transfer payment flow is as follows: 


1. 


The customer clicks Pay by Bank Transfer on the merchant website and is redirected to the 
Skrill Wallet Checkout payment form. Note that the payment form can also be displayed in 
an iframe. 

The customer selects a local bank from a drop-down menu in the payment form (the list of 
available banks depends on the country selected). If the bank supports Manual Bank 
Transfer then the payment flow continues, otherwise the flow will be as described in Direct 
Bank Transfer above. 

The customer clicks Proceed to Online Bank. A form is displayed showing the manual bank 
transfer details required to complete the payment. Note that the amount will always be 
displayed in the local currency in that country rather than the currency selected in the 
Merchant website. The transfer details will always be displayed in the local language. 

The customer clicks on Do Transfer (Realizar Transferencia in Spanish) to be redirected to 
the selected bank's website where they can manually complete the payment. 

Once the transfer is complete, the customer clicks Already Deposited (Ya Desposité in 
Spanish) in the Skrill payment form and a pending notice is shown on the Skrill payment 
form. This informs customer that payment is pending. 

The customer can now click the Continue button to return to the merchant website. The 
merchant website should check the payment status received at the status_url for the 
payment to determine the message to show to the customer. 

Once payment is complete, Skrill receives confirmation and sends a payment success 
notification to the merchant's status url. Note that this may take 1-2 days after the 
customer has made the bank transfer. When the merchant receives a valid payment 
confirmation with a status value of 2 at their status_url they can release the goods to the 
customer. 
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Bienvenido Emanual Sanchez | Salir 


30.00vus9 o A ACME 


Skrill e WW = 


: ; : 
EZRA > cama Lė. English version of text 


Bank transfers will be 


Las transferencias bancarias serán O” confirmed after the payment 
confirmadas una vez que el pago haya sido Hasb ved f 
remitido por su banco. Este proceso puede oa aa cad ia A 
tardar uno o dos días, transcurridos los cuales bank. This process may take 
el pago estará completado 1-2 days at which point your 
payment will be complete. 

Banco 

Santander D 

CPF 

10934510213 


Dirección de e-mail ¿Por qué? 
emanual_sanchez@paysafe.com 
Se le redirigira a su banco online para completar este 
pago 


PROCEDER A BANCO ONLINE 


Ges Skrill 


Figure 27- Manual bank transfer step 1 - enter name and ID and select a bank 
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Skrill 





Lea cuidadosamente las instrucciones de depósito para completar su 
pago. Cualquier error puede provocar demoras en la acreditación del pago. 


Relice la transferencia 
Deposite el valor exacto d ARS 483.53 (incluyendo decimales) 


antes de las 23.59 del corriente día en nuestra cuenta bancaria 





Datos Bancarios para Realizar la Trasferencia: 





Banco SANTANDER RIO 

Cuenta Única 168-012044/3 

CBU 0720168020000001204436 
CUIT/DNI 33714595569 

Beneficiario WEBPAY SRL 

Referencia 9982251 


Realizar Transferencia 


Continue con su compra 


Al completar la transferencia deberá hacer click en el botón “Ya deposité” en 
nuestro sitio a modo de completar su proceso de pago. 


Ya deposité 





Figure 28- Manual bank transfer step 2 - bank account details for manual transfer 


AN Santander Río Online Banking Personas 


Ingresá desde aquí 
para operar 






Bienvenido a 
Online Banking 


INGRESAR > 


INGRESO CON CLAVE NUEVA > 


Si ya operas con Online Banking 


Figure 29 - Manual bank transfer step 3 — log in to bank to make a manual transfer (not shown) 
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$ Español 


20. Duer A ACME 


Y 





Pago pendiente 


as bancarias serán confirm 
ago h 
50 puede tardar uno o dos días 


cuales el pago estará completado 





Las transferencia 
Jr jue e 









banco. Est 
transcurridos k 





Powered by 
Qe Skrill 


Figure 30 - Manual bank transfer step 4 - pending payment shown after clicking already paid 


5.2 Cash/Invoice 


The cash payment flow is as follows: 


1. 


The customer clicks Pay by Cash / Invoice on the merchant website. They are then 
redirected to the Skrill Wallet Checkout Payment form (or this form is displayed in an iframe 
/ lightbox) 

The customer selects a local bank from the drop-down menu (the list of available banks 
depends on the country selected). If the bank supports Online Bank Transfer then the 
payment flow continues, otherwise the flow will be as described in Offline Bank Transfer 
below. 

The customer enters their National Identity number (This field has a different name 
depending on the country e.g. CPF, RUT, ID, DNI, etc.) 

The customer is redirected to the bank / payment network website for confirmation. 

The bank website displays a bar code that the customer must print. 

The customer goes to the bank or a store which accepts payment in cash using the bar code 
they were given in step 6. Alternatively, they can pay the invoice using their Online Bank. 
Once payment is complete Skrill receives confirmation. Skrill sends a payment success 
notification to the merchant's status_url. 

Once the merchant receives a valid payment confirmation with a status value of 2 at the 
merchant's status, url they can release the goods to the customer. 
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Bienvenido Emanual Sanchez | Salir 


30.00us9 o ACME 


Skei MO] o 55 





Saldo Efectivo! 
; . ; 
Pa S expo 8 EP ed% = English version of text 
Cash payments will be 
Los pagos en efectivo se confirmaran una vez confirmed after the invoice 
se haya pagado la factura. Una vez recibido el e —————__ payment has been made. 
pago, el mismo se completará en los dos días Once received, your payment 
siguientes will be completed within the 
following two days. 
Banco S Y 
Efecty D 


10934510213 


| 
O 


Dirección de e-mail ¿Por qué? 


` 


Se le redirigirá a su banco online para completar este 
pago 


PROCEDER A PAGO EN EFECTIVO 


UD Skrill 


emanual_sanchez@paysafe.com 


Figure 31 — Cash payment step 1 — multiple cash payment options available 





Note: If only a single cash method is supported for the customer's country, then instead of a list of 
banks to select from, only the option and logo of the single payment method is shown. See 
the example below. For details of countries supporting cash payments, see Section 5.5 on 
page 75. 
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30.00us0 © A AO 


Skrill Vo — 7? e 
Saldo sa 


Los pagos en efectivo se confirmarán una vez 
se haya pagado la factura. Una vez recibido el 
pago, el mismo se completará en los dos días 
siguientes 





CPF 
10934510213 


Dirección de e-mail ¿Por qué? 
emanual_sanchez@paysafe.com 


Se le redirigira a su banco online para completar este 
pago 


PROCEDER A BOLETO 


iren Skrill 
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Only a single cash payment 
option is supported in the 
customer's country. 

The method's logo is 
displayed here. 


Figure 32 — Cash payment step 1 — only single cash payment option available 
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A 1010000010100 EI 
Recibo de pago referenciado 


cza] E Powered By: Tikrel 


Datos del Pago 





Descripción: ID : 8830047 
Valor: $18700 COP 


Datos Del Usuario: 





Documento Usuario 123045078 





Nombre 





Correo 


Continuar | 












































HIT" rea 


Tiene alguna duda sobre su código de pago? escriba a support@astropay.com Online Payment Solution 


Figure 33 - Cash payment step 2 


JA 0000804 
Recibo de pago referenciado 


A EJ Powered By: Tikrel 


Datos del Pago 





Descripción: ID : 8760133 
Valor: $3800 COP 


Datos Del Usuario: 





Documento Usuario 12304567 
Nombre 
Correo 


Metodos de pago Habilitados: 





Pago En Efectivo-Exito-Baloto v 


Pago En Efectivo-Exito-Baloto 








| Imprimir Codigo Barras || Finalizar | 























A A rea 


Tiene alguna duda sobre su código de pago? escriba a support@astropay.com Online Payment Solution 











Copyright © TuCompra S.A.S Administrador por RECAUDOEXPRESS 


Figure 34 - Cash payment step 3 
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RECAUDO EXPRESS UN PRODUCTO TUCOMPRA 


NOMBRE DEL COMERCIO 
Tikrel Colombia SAS - 





REFERENCIA DE PAGO: 1011013738 


CONSECUTIVO DEL COMERCIO: 8760133 


PAGADOR: 
VALORA CANCELAR 3800 


PAGAR HASTA VALOR A PAGAR 





20160422 
1. ESTE RECIBO ES VALIDO CON EL SELLO DEL PAGO Y CONFIRMADO POR EL MISMO 


. NO SE ACEPTAN PAGOS DESPUES DE LA FECHA DE PAGO MAXIMO. 


3. EL PAGO DE ESTE RECIBO NO MODIFICA LAS CONDICIONES DEL CONTRATO CON EL COMERCIO 


PARA SU COMODIDAD PUEDE REALIZAR EL PAGO DE SU FACTURA EN CUALQUIERA DE 
ESTOS MEDIOS 


GVA Toda Mora 5. A. 


CAJEROS AUTOMATICOS ap 
POMONA 





[GENERADO POR TU COMPRADAS NT ADIDAS 









REFERENCIA DE PAGO: 
1011013738 


FECHA 20100422 TONVENOS 


0 
exito- baloto-carulla-pomona-edeq- 
surtimax - super inter 
convenio 9595950963 


(415)7709998205406(8020)101 1013738(3900)00003800(96)20160422 












Figure 35 - Cash payment step 4 


@ Español 


30.002 © A ACME 


Y 


Pago pendiente 


Los pagos en efectivo se confirmarán una vez se 
haya pagado la factura. Una vez recibido el pago 
el mismo se completará en los dos días siguientes 


Ox Skill 


Figure 36 - Cash payment step 5 
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Astropay supports full and partial refunds. Customers receive an email when the merchant triggers a 
refund. This email contains a link to a form on the Astropay website with a Skrill logo where 
customers specify their name, a bank account and the security code contained in the email. Astropay 
will then send a refund to the customer’s bank. Refunds take up to two working days from receipt of 
these details. 


When, the refund is executed by the merchant, an email is sent to the customer and the refund is 
set to pending state. The refund changes state to processed when the customer provides their bank 
account details and Astropay sends the payment to their bank. Note that payment will still take up 
to two working days to reach the customer”s account. 





Warning: If you use the refund call in the Skrill Automated Payment Interface you must ensure that 
you provide a refund_status_url to record the change from pending to processed. 


Skrill 


Hola: John Payer 





Recibimos una solicitud para realizar el reembolso de COP 96138.03 frente a su pedido en el sitio de paysafe 
El plazo para recibir el reembolso es de 2 días hábiles a partir del envío de los datos bancarios. 


Para que efectuemos el depósito, es necesario que usted nos informe de sus datos bancarios accediendo al siguiente link: 


CLICK AQUÍ PARA COMPLETAR SUS DATOS PARA EL REEMBOLSO 


Código de seguridad:215107 


Atención: el link solo puede ser utilizado dos veces. 

Gracias por utilizar a AstroPay como su procesador de pagos 

En el caso de que desconozca cualquier pago realizado para este sitio, ignore este e-mail y este reembolso será cancelado 
automaticamente. 

O 2013 AstroPay, Inc. All rights reserved. 


Figure 37 Step 1 - Customer receives refund email 
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Œ | D https://astropaycard.com/refund/collect_data?token=6702e62b764bb8e6577c0741969baa26 VT O D e 


Skrill 


Formulario de reembolso 


Total del reembolso en COP: 31.00 


Nombre del titular de la cuenta 
bancaria: 

Nombre del banco: 

Número de agencia: 

Número de cuenta bancaria: 
Tipo de cuenta: 


Comentarios: 


DETALLES DE LA TRANSACCIÓN 








Referencia: 9399144 
Invoice: 1781369702 
Valor USD: 31.00 USD 
Monto local: 6138.03 COP 


Código de 
seguridad: 


ENVIAR 


Figure 38 Step 2 - Customer completes refund form 


5.4 Payment method codes 


The following table lists the payment method codes for Astropay and their effects. They are 
returned in the payment type parameter and show the Astropay payment type used. 


Table 24: Payment method codes 


























Transfer Type Effect Payment Method 
Direct Bank Transfer Shows the Bank Transfer payment tab. The bank selector | ADB 
only shows those banks in the customer's country which 
support Direct Bank Transfer rather than all banks. 
Manual Bank Transfer Shows the Bank Transfer payment tab. The bank selector | AOB 
only shows those banks in the customer's country which 
support Manual Bank Transfer rather than all banks. 
Cash / Invoice Shows the Cash payment tab. ACI 
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5.5 Lists of banks supported by country 





Note: This list may change. Contact Skrill prior to implementing this payment method for an up-to- 
date list. 





Table 25: Argentina 























Bank Type 

Santander Rio Direct Bank Transfer 
RedLink Cash 

Pago Fácil Cash 





Table 26: Brazil 


























Bank Type 

Itau Direct Bank Transfer 
Bradesco Direct Bank Transfer 
Banco do Brasil Direct Bank Transfer 
HSBC Manual Bank Transfer 
Caixa Manual Bank Transfer 
Santander Manual Bank Transfer 
Boleto Cash 














Note: The Quick Checkout payment form does not currently support Portuguese. Customers must 
use another supported language such as English or Spanish. 























Table 27: Chile 
Bank Type 
webpay Manual Bank Transfer 
Servipag Cash 





Table 28: Colombia 





























Bank Type 

Bancolombia Manual Bank Transfer 
PSE Manual Bank Transfer 
Efecty Cash 

Davivienda Cash 

Almancenes Éxito Cash 
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Bank Type 
Carulla Cash 
Empresa de Energía del Cash 
Quindio 
Surtimax Cash 

Table 29: Mexico 

Bank Type 
OXXO Cash 
BBVA Bancomer Cash 
BanDiners Cash 
Santander Cash 

Table 30: Peru 

Bank Type 
BBVA Cash 
BCP Cash 
InterBank Cash 
Pago Efectivo Cash 
ScotiaBank Cash 
Western Union Cash 

Table 31: Uruguay 

Bank Type 

Red Pagos Cash 
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6 APPENDICES 





6.1 ISO 4217 currencies accepted by Skrill 















































































































































EUR Euro TWD Taiwan Dollar 
USD U.S. Dollar THB Thailand Baht 
GBP British Pound CZK Czech Koruna 
HKD Hong Kong Dollar HUF Hungarian Forint 
SGD Singapore Dollar BGN Bulgarian Leva 
JPY Japanese Yen PLN Polish Zloty 
CAD Canadian Dollar ISK Iceland Krona 
AUD Australian Dollar INR Indian Rupee 
CHF Swiss Franc KRW South-Korean Won 
DKK Danish Krone ZAR South-African Rand 
SEK Swedish Krona RON Romanian Leu New 
NOK Norwegian Krone HRK Croatian Kuna 
ILS Israeli Shekel JOD Jordanian Dinar 
MYR Malaysian Ringgit OMR Omani Rial 
NZD New Zealand Dollar RSD Serbian Dinar 
TRY New Turkish Lira TND Tunisian Dinar 
AED Utd. Arab Emir. Dirham BHD Bahraini Dinar 
MAD Moroccan Dirham KWD Kuwaiti Dinar 
QAR Qatari Rial COP Colombian Peso 
SAR Saudi Riyal 
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6.2 Languages supported by Skrill 


Skrill supports the following languages (2-character ISO codes): 


Bulgarian (BG) 
Chinese (ZH) 
Czech (CS) 
Danish (DA) 
Dutch (NL) 
English (EN) 
Finnish (FI) 
French (FR) 
Greek (EL) 
Italian (IT) 
Japanese (JA) 
Polish (PL) 
Portuguese (PT) 
Romanian (RO) 
Russian (RU) 
Spanish (ES) 
Swedish (SV) 
Turkish (TR) 
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6.3 ISO country codes (3-digit) 
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Skrill does not accept customers from the following countries: Afghanistan, Cuba, Eritrea, Iran, Iraq, 


Japan, Kyrgyzstan, Libya, North Korea, Sudan, South Sudan and Syria 




























































































Aland Islands ALA Christmas Island CXR Guernsey GGY 
Albania ALB Cocos (Keeling) CCK Guinea HTI 
Islands 
Algeria DZA Congo, the COD Guinea-Bissau HMD 
Democratic Republic 
American Samoa ASM Cook Islands COK Guyana VAT 
Andorra AND Costa Rica CRI Haiti GIN 
Angola AGO Colombia COL Heard Island and GNB 
McDonald Islands 
Anguilla AIA Comoros COM Holy See (Vatican City GUY 
State) 
Antarctica ATA Congo, Republic of COG Honduras HND 
Antigua and Barbuda ATG Cote d'Ivoire CIV Hong Kong HKG 
Argentina ARG Croatia HRV Hungary HUN 
Armenia ARM Cyprus CYP Iceland ISL 
Aruba ABW. Czech Republic CZE India IND 
Australia AUS Denmark DNK Indonesia IDN 
Austria AUT Djibouti DJI Ireland IRL 
Azerbaijan AZE Dominica DMA Isle of Man IMN 
Bahamas BHS Dominican Republic DOM Israel ISR 
Bahrain BHR Ecuador ECU Italy ITA 
Bangladesh BGD Egypt EGY Jamaica JAM 
Barbados BRB El Salvador SLV Japan JPN 
Belarus BLR Equatorial Guinea GNQ Jersey JEY 
Belgium BEL Eritrea ERI Jordan JOR 
Belize BLZ Estonia EST Kazakhstan KAZ 
Benin BEN Ethiopia ETH Kenya KEN 
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Bermuda BMU Falkland Islands FLK Kiribati KIR 
(Malvinas) 
Bhutan BTN Faroe Islands FRO Korea, Republic of KOR 
Bolivia BOL Fiji FJI Kuwait KWT 
Bosnia and BIH Finland FIN Lao People's LAO 
Herzegovina Democratic Republic 
Botswana BWA France FRA Latvia LVA 
Bouvet Island BVT French Guiana GUF Lebanon LBN 
Brazil BRA French Polynesia PYF Lesotho LSO 
Brunei Darussalam BRN French Southern ATF Liberia LBR 
Territories 
Bulgaria BGR Gabon GAB Liechtenstein LIE 
Burkina Faso BFA Gambia GMB Lithuania LTU 
Burundi BDI Georgia GEO Luxembourg LUX 
Cambodia KHM Germany DEU Macao MAC 
Cameroon CMR Ghana GHA Macedonia MKD 
Canada CAN Gibraltar GIB Madagascar MDG 
Cape Verde CPV Greece GRC Malawi MWI 
Cayman Islands CYM Greenland GRL Malaysia MYS 
Central African CAF Grenada GRD Maldives MDV 
Republic 
Chad TCD Guadeloupe GLP Mali MLI 
Chile CHL Guam GUM Malta MLT 
China CHN Guatemala GTM Marshall Islands MHL 
Martinique MTQ Puerto Rico PRI Tokelau TKL 
Mauritania MRT Qatar QAT Tonga TON 
Mauritius MUS Reunion REU Trinidad and Tobago TTO 
Mayotte MYT Romania ROU Tunisia TUN 
Mexico MEX Russian Federation RUS Turkey TUR 
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Micronesia, Federated FSM Rwanda RWA Turkmenistan TKM 
States of 
Moldova MDA Saint Helena SHN Turks and Caicos TCA 
Islands 
Monaco MCO Saint Kitts and Nevis KNA Tuvalu TUV 
Mongolia MNG Saint Lucia LCA Uganda UGA 
Montenegro MNE Saint Martin (French MAF Ukraine UKR 
part) 
Montserrat MSR Saint Pierre and SPM United Arab Emirates ARE 
Miquelon 
Morocco MAR Saint Vincent and the VCT United Kingdom GBR 
Grenadines 
Mozambique MOZ Samoa WSM United States USA 
Myanmar MMR San Marino SMR United States Minor UMI 
Outlying Islands 
Namibia NAM Sao Tome and STP Uruguay URY 
Principe 
Nepal NPL Saudi Arabia SAU Uzbekistan UZB 
Netherlands NLD Senegal SEN Vanuatu VUT 
Netherlands Antilles ANT Serbia SRB Venezuela VEN 
New Caledonia NCL Seychelles SYC Viet Nam VNM 
New Zealand NZL Sierra Leone SLE Virgin Islands, British VGB 
Nicaragua NIC Singapore SGP Virgin Islands, U.S. VIR 
Niger NER Slovakia SVK Wallis and Futuna WLF 
Nigeria NGA Slovenia SVN Western Sahara ESH 
Niue NIU Solomon Islands SLB Yemen YEM 
Norfolk Island NFK Somalia SOM Zambia ZMB 
Northern Mariana MNP South Africa ZAF Zimbabwe ZWE 
Islands 
Norway NOR South Georgia and SGS 
the South Sandwich 
Islands 
Spain ESP 
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Oman OMN Sri Lanka LKA 

Pakistan PAK Suriname SUR 

Palau PLW Svalbard and Jan SIM 
Mayen 

Palestinian Territory, PSE Swaziland SWZ 

Occupied 

Panama PAN Sweden SWE 

Papua New Guinea PNG Switzerland CHE 

Paraguay PRY Taiwan, Province of TWN 
China 

Peru PER Tajikistan TJK 

Philippines PHL Tanzania, United TZA 
Republic of 

Pitcairn PCN Thailand THA 

Poland POL Timor-Leste TLS 

Portugal PRT Togo TGO 




















6.4 MDS signature 


A hidden text field called md5sig is included in the form submitted to your server. The value of this 
field is a 128-bit message digest, expressed as a string of thirty-two hexadecimal digits in 
UPPERCASE. The md5sig is constructed by performing an MDS calculation on a string built up by 


e merchant id 

e transaction id 

e the uppercase MDS value of the ASCII equivalent of the secret word submitted in the 
Settings > Developer Settings section of your online Skrill account. 

e mb amount 

e mb currency 

e status 


The purpose of the md5sig field is to ensure the integrity of the data posted back to your server. You 
should always compare the md5sig field's value posted by Skrill's servers with the one you 
calculated. 


To calculate the md5sig, you need to take the values of the fields listed above exactly as they were 
posted back to you, concatenate them and perform a MDS calculation on this string. 
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Cancelled payment 


The MD5 hash posted on the 'ondemand_status_url' when a Skrill 1-Tap payment has been 
cancelled is a concatenation of the following fields: 


MERCHANT_ID = merchant_id 

MERCHANT_TRN_ID = transaction_id 

The uppercase MD5 value of the ASCII equivalent of the secret word submitted in the Settings > 

Developer Settings section of the Merchant’s online Skrill account 

REC_PMT_STATUS = status 

TRN ID=rec payment id 
The MD5 hash for 1-Tap payments, posted on the status url” is calculated in the same way as for 
normal payments/refunds. 


Secret word 


The secret word must be submitted in the Settings > Developer Settings section of your Skrill Digital 
Wallet account before the md5sig can be used. The following restrictions apply when submitting 
your secret word: 


e All characters must be in lowercase 
e The length should not exceed 10 characters 
e Special characters are not permitted (e.g. @, %, $, etc.) 





Note: If the Settings > Developer Settings section is not displayed in your account, contact 


merchantservices@skrill.com. 


6.5 SHA2 signature 


To improve the security of the status reports, Skrill post an additional parameter with the report 
called 'sha2sig'. This is constructed in the same way as the md5 signature, but with a different 
hashing algorithm. 


This new parameter is not available by default. To enable this option, send a request to 


merchantservices @skrill.com. 


6.6 Example HTML forms 


Below are two examples of HTML forms that can be submitted to Skrill. The first one is a basic 
example. The second example uses several additional features currently available with the Skrill 
Wallet Checkout. 


You can use these forms, ensuring that the values are replaced with your own values. 





Note: For experimental purposes you can use our test form at 
https://www.skrill.com/app/test_payment.pl. 
To request a test account and test data, contact merchantservices @skrill.com. 





We provide a test Wallet Checkout merchant account, demowallet@sun-fish.com, which you can set 
as the pay_to_email. 
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<form action="https://pay.skrill.com" method="post" target="_blank"> 











<input type="hidden" 
<input type="hidden" 
<input type="hidden" 
<input type="hidden" 
<input type="hidden" 
<input type="hidden" 
<input type="hidden" 
<input type="hidden" 
Shakespeare) "> 
<input type="submit" 











</form> 


name="pay to email" value="demowallet@sun-fish.com"> 
ame="status_url" value="contact@example.com"> 
ame="recipient description" value="ACME Solutions”> 





n 
n 

name="language" value="EN"> 

name="amount" value="39.60"> 
name="currency" value="GBP"> 
n 
n 





ame="detaill description" value="Description:"> 











ame="detaill text" value="Romeo and Juliet (W. 


value="Pay!"> 
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<form action="https://pay.skrill.com" method="post" target="_blank"> 

<input type="hidden" name="pay to email" value="demowallet@sun-fish.com"> 

<input type="hidden" name="transaction id" value="A10005"> 

<input type="hidden" name="recipient description" value="ACME Solutions”> 
<input type="hidden" name="return url" 
value="http://www.skrill.com/payment made.html"> 

<input type="hidden" name="cancel url" value="http://www. 
skrill.com/payment cancelled.html"> 

<input type="hidden" name="status url" value="https://www. 
skrill.com/process payment.cgi"> 

<input type="hidden" name="language" value="EN"> 

<input type="hidden" name="merchant fields" value="customer number, 
session id"> 

<input type="hidden" name="customer number" value="C1234"> 

<input type="hidden" name="session ID" value="A3DFA2234"> 

<input type="hidden" name="pay from email" value="payer123@skrill.com"> 

<input type="hidden" name="amount2 description" value="Product Price:"> 

<input type="hidden" name="amount2" value="29.90"> 

<input type="hidden" name="amount3 description" value="Handling Fees & 
Charges:"> 

<input type="hidden" name="amount3" value="3.10"> 

<input type="hidden" name="amount4 description" value="VAT (20%) :"> 

<input type="hidden" name="amount4" value="6.60"> 

<input type="hidden" name="amount" value="39.60"> 

<input type="hidden" name="currency" value="GBP"> 

<input type="hidden" name="firstname" value="John"> 

<input type="hidden" name="lastname" value="Payer"> 

<input type="hidden" name="address" value="Payerstreet"> 

<input type="hidden" name="postal code" value="EC45MQ"> 

<input type="hidden" name="city" value="Payertown"> 

<input type="hidden" name="country" value="GBR"> 

<input type="hidden" name="detaill description" value="Product ID:"> 

<input type="hidden" name="detaill text" value="4509334"> 

<input type="hidden" name="detail2 description" value="Description: "> 

<input type="hidden" name="detail2 text" value="Romeo and Juliet (W. 
Shakespeare) "> 

<input type="hidden" name="detail3 description" value="Special 
Conditions: "> 

<input type="hidden" name="detail3 text" value="5-6 days for delivery"> 

<input name="logo url" type="hidden" value="https://s3-eu-west- 
1.amazonaws.com/uploads- 


eu.hipchat.com/85350/649769/30JtX2NNZNv6SgX/Screen$20Shot%202014-08- 


14320a 
<inp 
</form 


t%2017.39.12.png"> 
ut type="submit" value="Pay!"> 
> 
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6.7 Payment method codes 


The table below details the codes required to pre-select a payment method when using the 
Gateway. These codes are also used in the payment_type field (where used) to return the payment 
type the customer used. Note that the individual Credit Card codes: MSC, VSD, VSE, MAE, AMX, DIN, 
and JCB are only used in the payment_type field. 
































Payment Method Value Supported Countries 

Skrill Wallet WLT ALL 

Credit/Debit Cards 

All Card Types ACC ALL 

Visa VSA ALL 

MasterCard MSC ALL 

Visa Delta/Debit VSD United Kingdom 

Visa Electron VSE ALL (excluding US) 

Maestro MAE United Kingdom, Spain, Ireland & Austria 
Paysafecard PSC American Samoa, Austria, Belgium, Canada, 


Croatia, Cyprus, Czech Republic, Denmark, 
Finland, France, Germany, Guam, 

Hungary, Ireland, Italy, Latvia, Luxembourg, 
Malta, Mexico, Netherlands, Northern Mariana 
Islands, Norway, Poland, Portugal, Puerto Rico, 
Romania, Slovakia, Slovenia, Spain, Sweden, 
Switzerland, Turkey, United Kingdom, United 


States of America and US Virgin Islands 





Paysafecash PCH Austria, Belgium, Bulgaria, Canada, Croatia, Cyprus, 
Czech Republic, France, Greece, Hungary, Ireland, 
Italy, Latvia, Lithuania, Luxembourg, Malta, Mexico, 
Netherlands, Poland, Portugal, Romania, Slovakia, 
Slovenia, Spain, Sweden, Switzerland, United 
Kingdom, and the USA. 














Carte Bleue GCB France 
Dankort DNK Denmark 
PostePay PSP Italy 
CartaSi CSI Italy 











Instant Banking Options 
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Payment Method Value Supported Countries 

Rapid Transfer (Online Bank OBT / NGP Austria, Belgium, Denmark, Estonia, Finland, France, 

Transfer) (See Note) Germany, Greece, Hungary, Italy, Latvia, 

(Previously called Skrill Direct) Netherlands, Norway, Poland, Portugal, Spain, 
Sweden, UK. 
Note: Only NGP is returned for this payment method 
in payment_type if detailed payment type 
information is enabled for your account. 

giropay GIR Germany 

Klarna SFT Germany, Austria, Belgium, Netherlands, Italy, and 
Spain. 

iDEAL IDL/GCI* Netherlands 
*Note: IDL is the only value allowed for this 
payment method in a request. GCI is returned in 
payment_type for this payment method after a 
gaming payment through GlobalConnect, but only if 
detailed payment type information is enabled for 
your account. 

Przelewy24 PWY Poland 

Trustly GLU Sweden, Finland, Denmark, Estonia, Poland, Spain, 
Latvia, Lithuania, Germany, Netherlands, Austria, 
Czech Republic, Slovakia, UK, Norway and Belgium. 

Other Options 

Astropay - Direct Bank Transfer ADB Argentina, India, Chile 

Astropay - Manual Bank Transfer AOB Chile, Colombia 
Argentina, Brazil, Chile, China Colombia, Mexico, Peru, 

Astropay - Cash / Invoice ACI 
Uruguay 

Rapyd RBR Brazil, Chile, Columbia, Mexico, Peru 
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6.8 Failed reason codes 


The table below contains all possible values of the “failed reason code” parameter and their 


corresponding meanings. Failed reason codes are mappings of the codes Skrill receives from external 


processors and any failures due to internal procedures. 

















































































































Code Description 
1 Referred by Card Issuer 
2 Invalid Merchant 
3 Pick up Card 
4 Declined by Card Issuer 
5 Insufficient funds 
6 Transaction failed 
7 Incorrect PIN 
8 PIN tries exceed - card blocked 
9 Invalid Transaction 
10 Transaction frequency limit exceeded 
11 Invalid Amount/ Amount too high /Limit Exceeded 
12 Invalid credit card or bank account 
13 Invalid Card Issuer 
15 Duplicate transaction 
19 Retry transaction 
24 Card expired 
27 Requested function not available 
28 Lost/Stolen card 
30 Format Failure 
32 Card Security Code (CVV2/CVC2) Check Failed 
34 Illegal Transaction 
37 Card restricted by Card Issuer 
38 Security Violation 
42 Card blocked by Card Issuer 
44 Card Issuing Bank or Network is not available 
45 Processing error - card type is not processed by the authorization centre 
51 System error 
58 Transaction not permitted by acquirer 
63 Transaction not permitted to cardholder 
67 BitPay session expired 
70 Customer failed 3DS verification 
80 Fraud rules declined 
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Code Description 
98 Error in communication with provider 
99 Other 
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7 GLOSSARY 





This section provides a description of key terms used in this guide. 


Term 


Automated Payments 
Interface (API) 


Browser 


Chargeback 


Concatenation 


Credit card 


Customer ID 


Customer services team 


Debit card 


Dynamic descriptor 


HTML POST 


iframe 


Integration 


ISO country codes 


ISO currency codes 
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Explanation 


The API is a collection of tools that enables merchants to execute requests to 


make refunds, check the status of transactions and download reports. 


Application that enables a customer or merchant to access web pages. 
Examples include: Internet Explorer, Google Chrome and Mozilla Firefox. 


The return of funds, previously authorised in a transaction, to a customer, 
which is initiated by their bank. The merchant may incur an administration cost 
for Skrill processing the dispute, in addition to any amount eventually credited 
back to the customer. 


Combining of multiple fields or parameters into a single text string or 
parameter. 


A type of payment card that allows customers to pay for goods and services 
using funds that are loaned. The loan must be paid back within a specified 
period. Interest is typically charged on the balance after a grace period 
(typically 20-55 days). 

Examples: Visa and MasterCard 


See also Debit card.ame 


Unique identifier for the customer or merchant's Skrill digital wallet account. 


Skrill team responsible for end-customer support queries. Also referred to as 


immediately taken from the customer's account, instead of being paid back 
later. So, the customer must have sufficient funds in their account or an agreed 
overdraft limit to cover the payment. 


An option that allows merchants to have their trading or brand name shown 
on the bank or credit card statement of the customer. The description can be 
changed on a per transaction basis. This option is only supported for Klarna 
and Direct Debit. 


HTML feature that enables the Skrill Wallet Checkout pages to be displayed 
within a frame on the merchant's website. The customer is not aware that they 
have been redirected to a third-party website. 


Process undertaken by merchants to ensure that their website or shopping cart 
can connect to and communicate with Skrill. 


3-digit country code of the International Standards organisation (ISO) that 
identifies the country. For example, GBR for United Kingdom. ISO country 
codes also exist in a 2-digit format. 


3-digit currency code of the International Standards Organisation (ISO) that 
identifies the currency. For example, GBP for British Pound. 


Page 90 


Term 


Klarna 


Merchant Services team 


My Account 

Online Bank Transfer 
Payment Methods 
parameter 


Payment form 


Payment option or 
payment method 


Real-time 


Reason code 


Skrill 1-Tap 


Skrill Digital Wallet 


Skrill Wallet Checkout 


Transaction 


Transaction ID 


Transaction status 
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Explanation 


Klarna is a real-time bank transfer payment method (was called Sofort). 
Customers can initiate a credit transfer during their online purchase - the 
transfer order is instantly confirmed to the merchant, allowing an instant 
delivery of goods and services. 


Skrill team responsible for providing technical and service support to 
merchants. 


Merchant and customer account administration portal that enables viewing of 
transactions and transferring funds. 


A payment method enabling customers to transfer funds from their bank 
accounts to their Skrill account in real-time. 


Option that allows merchants to pre-select the payment method they want to 
display first to customers on the payment page. 


Form used to collect payment method details from the customer during an 
online transaction. 


The payment method used by the customer, such as debit card, credit card and 
bank transfer. Note that in the payments industry, the terms payment method, 
payment option and payment type are often used interchangeably. 


An event that occurs instantly or within a short period, such as seconds or 
minutes. For a real-time transaction, the customer, merchant or Skrill receive a 
response to the transaction request while the customer is still online. 


Every transaction has a reason code, which indicates the status of the 
transaction. Skrill receives a variety of reason codes from the bank or scheme 
authorising the transaction and consolidates these before providing them to 
merchants. 


Skrill product that enables customers to pay online with a single tap or click. It 
enables merchants to automatically debit transactions from the customer's 
Skrill account without the customer having to authorise each time. 


Skrill's Digital Wallet, enabling customers to link cards and pay directly from 
their wallet account using cards or bank transfer. Up to 4 payment cards and 
10 bank accounts can be linked to a wallet account. 


Skrill’s secure page for processing transactions using a customer's Skrill 
account. Merchants connect to the Wallet Checkout, which will then process 
transactions from their website. 


Each financial interaction with the Skrill Wallet Checkout is referred to as a 


processed, pending, cancelled, failed, and chargeback. 
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8 INDEX 





Advanced HTML form, 85 


Alternative method of redirecting the 
customer, 17 


Astropay Bank Transfer, 61 

Astropay Cash/Invoice, 68 

Astropay Refunds, 73 

Chargeback notification, 38 

Checking or Cancelling 1-Tap Payments, 56 
Connect to the Payment Gateway, 9 
Contact for queries, 8 

Customer is not registered with Skrill, 21 
Dynamic Descriptor, 38 

Enable the MQI and API, 42 

Example HTML forms, 83 

Failed reason codes, 88 

Gateway demonstration, 11 

Gateway options, 34 

Iframe target, 39 

ISO 4217 currencies, 77 

ISO country codes (3-digit), 79 
Languages supported, 78 

MDS signature, 82 
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Merchant Query Interface, 29 
Merchant refunds, 38 
MAI Error Messages, 59 


Parameters to be posted to the Skrill 
Gateway, 12 


Payment method codes, 86 
Payment process, 10 
Steps, 11 

Payment process steps 
Redirect to the Skrill Gateway, 11 
Status page, 26 

Recurring Billing, 35 

Recurring billing status, 36 

Secure return url parameter, 37 

SHA2 signature, 83 

Simple HTML form, 84 

Skrill 1-Tap payment, 42 

Skrill Status report, 27 

Status description, 29 

Taking Subsequent 1-Tap Payments, 50 

Test account, 8 


Validating the status report, 29 
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